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Preface 



Required Publications 



Related Publications 



This publication provides installation managers, system programmers, and operators 
with the information required to plan for, install, and use SMF in both VSl and VS2. 
Information is common to both systems unless specifically indicated otherwise. HASP 
information is for planning purposes only until its availability. 

This publication has the following major divisions: 

• "Introduction," which introduces SMF records and exits and discusses the 
compatibility of SMF between VSl and MFT, VS2 and MVT, and VSl and VS2. It 
also describes the basic SMF functions and the relationship of SMF to the 
operating system and to user written exit routines. 

• "Incorporating SMF into the System," which describes procedures for 
incorporating SMF into an operating system. 

• "System Information and Requirements," which describes storage requirements, 
performance, and operational considerations such as IPL and data management 
procedures. 

• "Report Programs," which describes sorting SMF records and designing report 
programs. 

• "Exit Routines," which describes planning, writing, and testing user written exit 
routines. 

• "Accounting Records," which fully describes the accounting records. 

• "Data Set Activity Records," which fully describes the data set activity records. 

• "Volume Records," which fully describes the volume records. 

• "System Use Records," which fully describes the system use records. 

• "Appendix A: Field to Record Cross Reference," which lists all the fields in 
alphabetic order and gives the record types containing each field. 

• "Index," which is a subject index to this publication. 



The following publications are required for use with the book you are now reading: 

• OS/VS Message Library: VSl System Messages, GC38-1001, and OS/VS 
Message Library: VS2 System Messages, GC3 8- 1002, which contain a listing 
and explanation of the messages issued by SMF. 

• OS /VSl System Data Areas, SY28 -0605, and OS/VS2 System Data Areas, 
SY28-0606, which contain additional information on the contents of SMF records. 



The reader should be familiar with the information presented in the following 
publications: 

• OS/VS Assembler Programmer's Guide, GC 3 3 -4021, which describes the 
ASMFCL cataloged procedure, which is used to link-edit sample exit routines. 

• OS/VS JCL Reference , GG28-0618, which describes the OUTLIM parameter, 
which is used in conjunction with a user written exit routine. 



Preface 



Notation Conventions 

Bold Type 
Italic Type 



• OS/VS Data Management Services Guide, GC26-3783, which describes the 
record descriptor word (RDW) used to write records in the SMF data set. 

• OS/VS1 System Generation Reference, GC26-3791, and OS/VS2 System 
Generation Reference , GC26-3792, which describe the system generation 
program used to include SMF and associated functions into the operating system. 

• OS/VS Utilities , GC3 5-0005, which describes the IEBUPDTE and IEBDG utility 
programs, which are used to enter the smfdeflt data set into SYSI.parmlib and 
to generate samples of standard parameter lists for exit routines. 

• OS/VS1 Job Management Logic, SY24-5161, and OS/VS2 Job 
Management Logic , SY28-0621, which describe the OUTLIM parameter. 

• OS/VS1 Storage Estimates , GC24-5094, and OS/VS2 Storage Estimates, 
GC28-0604, which provide information on storage requirements. 

• Operator's Library: OS/VS 1 Reference, GC38-0110, and Operator's Library: 
OS/VS2 Reference, GC38-0210, which describe the HALT command. 

• OS/ VS Supervisor Services and Macros , GC27-6979, which describes step 
priorities. 

• OS/VS Message Library: VS1 System Codes, GC38-1003, and OS/VS 
Message Library: VS2 System Codes, GC3 8- 1008 which describe system 
completion codes. 

• OS/VS1 RES: System Programmer's Guide, GC28-6878, which describes 
Remote Entry Services. 

• OS/VS1 Planning and Use Guide , GC24-5090, which provides information 
on handling accounting information when SMF=BASIC is specified. 

. OS/VS2 HASP II (V.4) Systems Programmer's Guide , GC27-6992, which 
describes the HASPGEN parameters that relate to SMF and the procedure for 
including the exit IEFUJP into HASP. 

For information on the PL/I and Sort/Merge program products, you may refer to 
PL/I Language, SC3 3-0009 and to Sort/Merge, SM/1, Programmer's Guide, 
SC33-4007. 



The format of the parameters and instructions shown in this publication is governed 
by the rules of notation discussed below. 



Information in bold type (NONE, NSL, etc.) must be entered exactly as shown. 



Information in italics (xx , register address , etc.) indicates data to be supplied by 
the user. In the following examples: 

BUF= n 

VOL=SER= vol.ser.no. 

n is replaced by a number and vol.ser.no. is replaced by a volume serial number. 
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Special Characters 



Punctuation 



Braces 



Brackets 



Underscores 



Special characters are used to indicate alternative items and required blank 
characters. Alternative items are separated by an OR sign ( | ). No more than one of 
the items separated by OR signs may be selected. In the following example: 

1|2|3 

only one of the values may be selected. 

A required blank character is indicated by b . In the following example, a blank is 
required between DD and DUMMY: 

DDb DUMMY 



The punctuation used in the commands (commas, semicolons, colons, and 
apostrophes) must be entered as shown. 



Braces { } indicate a choice of entry. You must include one, and only one, entry. If 
there are several choices within braces, you may enter any one of the choices. The 
braces themselves are never entered. In either of the following examples: 

{NO | YES} {NO} 
{YES} 

you must enter either the word NO or the word YES. 



Brackets [ ] indicate an optional value. The brackets themselves are never entered. 
In the following example: 

KEYWORD= value [, value! ] 

value! is optional and need not be entered. 

Underscores indicate the value that is assumed if no value is entered. Values that are 
assumed are called defaults. In the following example: 

[YES | NO] 

if no value is given, YES is assumed. 
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Summary of Major Changes 



• Addition of RES information for VS1 systems. 

• Addition of HASP information for VS2 systems. 

• Addition of exit IEFUJP in VS2 systems with HASP. 



Summary of Major Changes 1 1 



Introduction 



SMF (System Management Facilities) is a feature of OS/VS that provides the means 
for gathering and recording information that can be used for billing customers or 
evaluating system usage. Information is gathered and recorded by SMF data 
collection routines and by user written exit routines. Because the data collection and 
exit routines are independent of one another, they may be used in combination or 
separately. 

Note: SMF cannot be used for system tasks. In VS2 only, SMF cannot be used for 
problem programs started from the console. 

SMF data collection routines gather several types of information: 

• Accounting information, such as CPU time and device and storage usage. 

• Data set activity information, such as EXCP count and the user of the data set. 

• Volume information, such as the space available on direct access volumes and 
error statistics for tape volumes. 

• System use information, such as system wait time and I/O configuration. 

The type of data to be collected can be modified by the operator at each initial 
program loading (I PL). 

Through user written analysis and report routines, this information can be used in a 
variety of ways. For example, this information can be used to prepare customer's 
bills. The information might also be used to measure system usage against 
departmental standards of efficiency and performance. 

SMF is not, however, confined to after-the-fact analysis. SMF allows you to write exit 
routines that can monitor a job or job step at various points during its processing 
cycle — from control statement analysis to termination of the job. Therefore, by 
adding installation routines at the appropriate exits, standards of identification, 
priority, resource allocation, and maximum execution time can be enforced. 

Here's an example of using both facilities provided by SMF. By using and analyzing 
the information obtained by the data collection routines, the installation manager 
determines the average time each job step uses the CPU. In general, he finds that job 
steps exceeding this time limit are in a loop or unending wait state. Time is being 
wasted and overall efficiency impaired. Therefore, the average is used to establish a 
time limit through an exit routine for each job or job step running on the system; a 
job exceeding the expected time limit will be terminated. However, there must be 
some way to allow a job to exceed the expected time limit. Therefore, a routine is 
coded for the time limit exit. This routine allows the operator to extend the run time 
for selected jobs, such as the inventory program at year's end. 



Data Collection 



Various routines within the control program format SMF records and write them to 
the SMF data set. At IPL you can select which of certain groups of SMF formatted 
records are to be recorded through the use of SMF control parameters. (See 
"Selecting SMF Records Using SMFDEFLT Parameters" in the chapter 
"Incorporating SMF into the System.") In addition to the records supplied by SMF, 
you can create records to supplement or replace SMF records in the user written 
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routines according to your record definitions and formats. (See "SMFWTM Macro 
Instruction" in the chapter "Exit Routines.") 

The records can be grouped according to the type of information they contain, as 
follows: 

• Accounting records, which describe for each job and job step (1) who used the 
system, (2) what was used in the system, (3) how much was used, and (4) the 
completion code. These records describe background jobs for both VS1 and VS2. 
They describe foreground jobs for VS2 only. 

• Data set activity records, which describe the characteristics, activity, and user of 
data sets. These records also contain information about the deletion and renaming 
of data sets. 

• Volume records, which describe the space available on direct access volumes and 
contain error statistics for tape volumes. 

• System use records, which describe the configuration of the system, give system 
statistics such as wait time and total paging statistics, describe SMF options in 
effect, and record the occurrence of certain events. The records describing RES 
are available in only VS1. 



Accounting Records 



Accounting records describe how much a job or job step used the system. Some of 
the information contained in these records includes identification fields, accounting 
information from the JOB and EXEC statements, priority, CPU time (the time a job 
or job step actually uses the CPU), SYSIN and SYSOUT usage, device usage, and job 
or job step completion code. This type of information can be used to bill customers 
for use of the system. 

Figure 1 lists the records included in the group of accounting records, describes 
when each record is written, and lists some of the information contained in each 
record. 

See the chapter "Accounting Records" for more information on and the complete 
format of each of the accounting records. 

Data Set Activity Records 

Data set activity records describe the characteristics, activity, and user of data sets. 
Some of the information contained in these records includes data set names, volume 
serial numbers, number of volumes, and various control block fields. This 
information can be used by user written routines that report the data sets used by 
each job or job step. 

Figure 2 lists the records included in the group of data set activity records, describes 
when each record is written, and lists some of the information contained in each 
record. 

See the chapter "Data Set Activity Records" for more information on and the 
complete format of each of the data set activity records. 
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Record Type 


When Written 


Information Contained 


4 


After normal or abnormal 
termination of a job step for 
background jobs. 


Job identification, time of day that certain 
events occur during step processing, step 
CPU time, amount of main storage 
allocated and used, devices used, step 
paging activity, completion code, step 
priority, step accounting data, termination 
indicator. 


5 


After normal or abnormal job 
termination for background jobs. 


Job identification, time of day that certain 
events occur during job processing, job 
CPU time, completion code, job priority, 
job accounting data, termination indicator. 


6 


After processing of a SYSOUT 
class or form within a class for a 
background job has finished. 


Writer start and end times, number of 
SYSOUT data sets within the class and form, 
number of logical records processed. 


26 


As a job is purged from the 
system in a VS2 system with 
HASP. 


Job identification, time of day that certain 
events occur during job processing, total 
amount of SYSOUT output for the job, 
accounting information. 


34 


Each time a LOGOFF function 
processes a step termination for a 
foreground job. 


Job step information, such as LOGON time, 
main storage occupancy time, number of 
TGETs and TPUTs issued, job step CPU time, 
completion code, and main storage used. 
(Similar to type 4, which is produced for 
background jobs.) 


35 


Each time a LOGOFF process has 
been completed for foreground 
jobs. 


Job information, such as LOGON time, 
number of TGETs and TPUTs, session 
completion code, LOGON priority, LOGON 
enqueue time, termination indicator, 
SYSOUT classes for the session, and session 
CPU time. (Similar to type 5, which is 
produced for background jobs.) 


40 


The dynamic allocation function 
processes a de-allocation, 
concatenation, or 
de-concatenation request for 
foreground jobs. 


Device class, unit type, channel/unit 
address, and EXCP count. (Record types 34 
and 40, together, can be considered the 
equivalent of record type 4 for background 
jobs.) 



Figure 1 . Table of Accounting Records Showing When They Are Written 
and the Information They Contain 



Record Type 


When Written 


Information Contained 


14 


A user's data set opened for 
input or rdback is closed or 
processed by EOV. 


Creation and expiration dates, device type, 
EXCP count, volume serial numbers, 
number of volumes, record format and 
length, and pertinent portions of system 
control blocks. 


15 


A user's data set opened for 
OUTPUT, UPDAT, INOUT, or 
OUTIN processing is closed or 
processed by EOV. 


Same type as record 14. 


17 


A user's data set is scratched. 


Data set name, number of volumes, volume 
serial numbers. 


18 


A data set is renamed. 


Old data set name, new data set name, 
number of volumes, vblume serial 
numbers. 


20 


Each time a job is initiated. 


Job identification, programmer's name, 
user identification, number and contents of 
accounting fields on JOB statement. 



Figure 2. Table of Data Set Activity Records Showing When They Are 
Written and the Information They Contain 
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Volume Use Records 



System Use Records 



Volume records describe the space available on direct access volumes and give error 
statistics for tape volumes. This information can be used by IFHSTATR or by user 
written routines thataddress problems of volume deterioration (defective tracks) 
and space fragmentation. (See "IFHSTATR" in OS/VS Utilities , GC35-0005.) 

Figure 3 lists the records included in the group of volume records, describes when 
each record is written, and lists some of the information contained in each record. 



Record Type 


When Written 


Information Contained 


19 


For each direct access device on 
line at ipl and when a HALT or 
SWITCH command is processed, 
and for any direct access device 
when it is demounted. 


Number of unused alternate tracks, number 
of unallocated cylinders and tracks, 
number of cylinders and tracks in the 
largest free extent, owner identification 
number. 


21 


When a user data set on magnetic 
tape is demounted. 


Volume serial number, channel/unit 
address, number of read and write errors. 



Figure 3. Table of Volume Records Showing When They Are Written 
and the Information They Contain 

See the chapter "Volume Records" for more information on and the complete 
format of each of the volume records. 



System use records describe the system configuration and SMF options in effect, give 
system statistics (such as system wait time and paging statistics), and record the 
occurrence of certain events. Some of the information contained in these records 
includes system identification, SMF options, number of bytes in both virtual and real 
storage, system wait time, paging statistics, and the I/O configuration. Some of the 
SMF events whose occurrences are recorded are the beginning and ending of a dump 
of the SMF data set and the beginning and ending of a period of time when data is 
not being recorded. This type of information can be used by user written programs 
that report system efficiency, performance, and usage. 

Figure 4 lists the records included in the group of system use records, describes 
when each record is written, and lists some of the information contained in each 
recofd. 
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Record Type 


When Written 


Information Contained 





During system initialization after 
I PL. 


Real and virtual storage size and SMF 
options in effect. 


1 


At SMF initialization and at the 
first job step termination 
following the expiration of a 
ten-minute interval of elapsed 
system time. 


CPU wait time, system paging statistics 
accumulated during all of the ten-minute 
intervals that expired since the last type 1 
record was written, the expiration time of 
the last ten-minute interval. 


2 


At the beginning of a dump data 

set. 


System identification and the time and date 
the record was moved to the SMF buffer. 
(This record is the standard record header.) 


3 


At the end of a dump data set. 


Same type as 2. 


7 


After any period when there was 
no smf data set available for 
recording. This is the first record 
written when an SMF data set 
again becomes available. 


Count of SMF records generated but not 
written and the start and end times of the 
period during which no records were 
written. 


8 


During system initialization after 
1PL. 


Descriptions of each online device at ipl. 
(Each entry description includes the device 
class, unit type, and channel/unit address.) 


9 


During processing of the VARY 
ONLINE operator command. 


Identification of the device added to the 
configuration. 


10 


After a device is added to the 
configuration. 


Identification of the device made available 
by device class, unit type, and device 
address. Job requiring the allocation is 
identified. 


11 


During processing of the VARY 
offline operator command. 


Identification of the device removed from 
the configuration. 


12 


During processing of HALT or 
SWITCH operator commands. 


System wait time and paging statistics since 
the last record type 1 and the time this 
record was built. 


13 


At I PL and after each define 
command is processed under vsi 
only. 


The amount of storage assigned to each 
partition. 


30 


Whenever the time sharing option 
is started with a START TS 
command under VS2 only. 


TSO information, such as the time sharing 
initiation procedure name, time sharing 
member name in sysi.parmlib, smf 
foreground options, storage available to 
TSO and background jobs, information 
indicating the characteristics of the time 
sharing task started, and time sharing 
configuration information, such as the 
number of swap devices and a device entry 
for each swap device. 


31 


Whenever the Terminal 
Input/Output Controller (TIOC) 
initialization routine is entered by 
the time sharing control (TSC) 
task as the result of a START TS 
command under VS2 only. 


Input/output control initialization 
information, such as the total number and 
size of time sharing buffers, number of 
buffers per user, number of buffers 
reserved on the free queue, and number of 
users that constitute slack time. 



Figure 4. Table of System Use Records Showing When They Are Written 
and the Information They Contain (Part 1 of 2) 



Introduction 



17 



Record Type 


When Written 


Information Contained 


32 


Whenever the driver initialization 
routine is entered by the TSC task 
as the result of a START TS 
command under VS2 only. 


Guaranteed background execution 
percentage, information about the users on 
each subqueue, such as minimum time slice 
to be given to a user on the subqueue. 


33 


Whenever the driver modify 
routine is entered as a result of a 
modify driver command under 
VS2 only. 


Modifications made to the driver. (This 
information is similar to that contained in 
record type 32.) 


41 


Each time a MODIFY TS 
command is issued under VS2 
only. 


Modifications to TSO. (This information is 
similar to that contained in record type 30.) 


42 


During the termination of time 
sharing options and when the TSC 
abnormally terminates one or 
more time sharing regions and 
none is restarted under VS2 only. 


Time sharing initiation procedure name 
and time sharing task identifier. 


43 


During RTAM initialization under 
VS1 only. 


RES information including name of RTAM 
start procedure, maximum numbers of 
readers and writers, number of entries in 
LINE table, number of line DCTs, number 
of lines to activate, line names, and unit 
addresses. 


44 


Whenever a MODIFY RTAM 
command is issued under VS1 
only. 


RES information including name of start 
procedure, type of modify, number of 
lines modified, line numbers, and unit 
addresses. 


45 


When a STOP rtam command is 
issued under VS1 only. 


RTAM information including name of 
RTAM stop procedure, stop status, and 
number of lines started when stop was 
received. 


47 


Whenever a valid LOGON record 
is received by RTAM under VS1 
only. 


RES information including QID entry, 
passback area, and LOGON record. 


48 


Whenever a LOGOFF record is 
received by RTAM under VS1 only^ 


RES information consisting of the QID 
entry. 


49 


Whenever an invalid LOGON 
record is received by RTAM under 
VSl only. 


RES information including the QID entry, 
passback area, and LOGON record. 



SYSOUT Messages 



Figure 4. Table of System Use Records Showing When They Are Written 
and the Information They Contain (Part 2 of 2) 

See the chapter "System Use Records" for more information on and the complete 
format of each of the system use records. 



In addition to the records written to the SMF data set, SMF writes four messages to 
the SYSOUT data set. These messages are assigned message numbers IEF373I, IEF374I, 
IEF3751, and IEF376I, and they indicate the start and end times for each job step and 
for each job. The text of these messages and an explanation of each is provided in 
OS/ VS Message Library: VSl System Messages, GC38-1001, and OS/ VS 
Message Library: VS2 System Messages, GC38-1002. 
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User Written Routines 



Your installation should provide two types of routines to take full advantage of the 
features of SMF: 

• Analysis and report routines that process and format information contained in the 
SMF and user data sets. These routines may produce billing reports, list the SMF 
data set, use a sort/merge program to re-order the data, or perform detailed 
analysis operations. 

• Exit routines that periodically monitor jobs and can write user records to the SMF 
or installation defined data set. 

SMF provides exits in the control program that can be used by user written routines. 
User written routines can monitor each job at specific points from the time it is 
encountered in the input stream to the time all spooled output has been written. 
These routines are referred to as exit routines. 

Like execution time for any other part of the control program, the execution time of 
the exit routines is added to system overhead and will degrade system throughput. 
The amount of the degradation depends on the length of the routines and the 
number of times each is performed during processing of a job. The advantages of 
including exit routines must be weighed against the factors affecting system 
throughput when choosing which exits to use. It is possible (by the SMFDEFLT 
parameters) to specify at I PL the suppression of all exits or only step-related exits, 
permitting the system to operate without the exit routines. 

The exits from the interpreter and the initiator/ terminator can be taken by jobs in 
either the foreground or background. For VS2, the time limit exit can be taken by 
background jobs only. The SMF writer exit in VS2 is taken for each SMF record 
generated; it is not job related. 

An installation can make use of any or all of these exits by providing user written 
exit routines and including them in the system library SYS1.AOS00 before system 
generation or in the link library SYS1.LINKLIB and SYS1. NUCLEUS for VS1 or in 
SYS1.LPALIB for VS2 after system generation. Dummy routines are automatically 
provided for all unused exits for which you do not supply your own routines. 

The user written exit routines can cancel jobs, write user-defined records to the SMF 
data set, access user-defined data sets, or enforce installation standards, such as 
identification, priority, and resource allocation. Because these routines become part 
of the control program where errors can cause repeated system failure, thorough 
debugging is important. For more information on testing and debugging, see 
"Testing Exit Routines" in the chapter "Exit Routines." 

The formats of the parameters passed to each exit routine are described in the 
chapter "Exit Routines." The procedure for adding user written routines to the 
system is described in the chapter "Incorporating SMF into the System." 
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Exits Available to Both VS1 and VS2 

The exits available for use under both VS1 and VS2 are: 



Job Validation (lEFUJV), which receives control from the job management 
routine of the control program before each job control statement (or cataloged 
procedure) encountered in the input stream is interpreted. One final entry is made 
after all of the JCL is interpreted. This exit is not taken for comment statements 
or for jobs started from the console. A return code from this exit specifies 
whether processing of this job is to continue. 

Job Initiation (IEFUJI), which receives control from the initiator routine of the 
control program when a job on the input queue is selected for initiation. A return 
code from this exit specifies whether the job is to be started or canceled. 

Step Initiation (IEFUSI), which receives control from the initiator just before each 
job step is started (prior to allocation). A return code from this exit specifies 
whether the step is to be started or the job canceled. 

Time Limit (IEFUTL), which receives control from the timer interruption handler 
whenever one of the following time limits expires: the job CPU time limit from the 
JOB statement, the step CPU time limit from the EXEC statement or reader 
procedure, or the continuous wait time limit for the job from SMFDEFLT. A 
return code from this exit specifies whether the job step is to be terminated or 
processing continued with a new time limit. 

Termination (IEFACTRT), which receives control from the terminator on the 
normal or abnormal termination of each job step and job. A return code from this 
exit specifies whether the job is to be continued or terminated (for job step entry 
only), and whether the SMF record is to be written or skipped. With SMF=BASIC 
in VS 1 this routine also receives control at the beginning of allocation. There are 
no SMF records to be considered with SMF=BASIC. 

Job Purge (IEFUJP), which receives control from the SYSOUT writer routine in a 
vsi system or from the HASPACCT routine in a VS2 system with HASP when a job 
not started from the console is ready to be purged from the system (after the job 
has terminated and all SYSOUT output that pertains to that job has been written). 
This exit does not return a code to the control program in a vsi system. In a VS2 
system with HASP, this exit does not return a code which specifies whether the 
SMF record is to be written or skipped. 



Exits Available to VS1 Only 

The exits available for use under vsi only are: 



Input Stream Validation (IEFUIV), which receives control from the input stream 
control routine every time a new job is encountered in the input stream when VS I 
is used. A return code from this exit specifies whether a job is to be accepted for 
processing. 

SYSOUT Limit (IEFUSO), which receives control from the I/O supervisor when the 
number of logical records written to a SYSOUT data set exceeds the output limit 
when VSI is used. A return code from this exit specifies whether the job is to be 
terminated or processing continued using a new SYSOUT limit. 



Exit Available to VS2 Only 

The exit available for use under VS2 only is: 



SMF Record (IEFU83), which receives control from the SVC83 routine before any 
record is written to the SMF data set when VS2 is used. A return code from this 
exit specifies whether to suppress the SMF record that is to be written. 
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SMF Operation 



Initializing 



Job Processing 



Figure 5 shows SMF incorporated into the operating system. The following 
paragraphs, which describe Figure 5, assume that user written exit routines are 
supplied for all SMF exits 1 , that all SMF-formatted records 2 are written to the SMF 
data set, and that user written analysis and report routines are supplied. In any real 
application, of course, the exit routines that are supplied and the records specified to 
be written to the SMF data set depend on the installation's requirements. 



At I PL, an SMF initialization routine receives control and reads in the member 
(SMFDEFLT) of SYS1.PARMLIB that contains SMF control parameters. The options 
specified in these parameters — including such options as whether both the data 
collection routines and the control program exits will be active and including the 
definition of the SMF data sets — will be typed out at the console if the operator is 
allowed to modify them for the current work day. (The default parameters can be 
permanently changed by replacing the member in SYS1.PARMLIB.) Before job 
processing begins, the SMF initialization routine records information about IPL, 
initial input/output configuration, and, for only VS1, the amount of storage assigned 
to each partition. 



As the input stream in VS1 is read in for processing, each new job causes control to 
pass to an input stream validation exit. This exit routine may verify whether the job 
is to be accepted for processing. Just before each job control statement is 
interpreted, the interpreter routine passes control to a job-validation exit routine. 
This routine may verify any fields in the JCL statement, modify JCL, or reject jobs 
that do not meet installation standards. After all JCL has been interpreted, the same 
job validation exit routine receives control for further validity checking. 

Before a job is initiated, the initiator routines pass control to a user written job 
initiation exit routine. In this routine, the user can decide whether to cancel or 
continue job processing based on accounting parameters associated with the job. 
Upon return from the routine, the SMF job commencement record is created and 
written to the SMF data set. This record is not written if the exit routine specifies 
that the job be canceled. 

Before a job step is initiated, control is passed to a step initiation user written exit 
routine. Here, processing similar to that done in the job initiation exit can be 
performed. 

When a step within the job ends either normally or abnormally, terminator routines 
create a job step record and, before the record is written, pass control to a user 
written accounting routine. The accounting routine may modify the SMF records, 
add a record to its own accounting data set, or add records to the SMF data set. This 
accounting routine also indicates whether the job is to continue (if a job step 
termination is being processed) and whether the job step termination record is to be 
written. Upon return, the job step record is written to the SMF data set unless the 
exit routine specifies that it be suppressed. 

At job termination, SMF creates a job information record and again passes control to 
the user written accounting routine. Upon return from this routine, the SMF job 
termination record is written unless the exit routine specifies that it be suppressed. 

1 Note that some exits are available only when vst is used, and that other exits are available only 
when VS2 is used. 

2 The SMF records written under VSl and VS2 are slightly different because of additional fields for 
VS2. 
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VS Control Program 



SYS1.PARMLIB 




SMF Records 



Management 
Information 



Figure 5. SMF in the Operating System 
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In VSl and in VS2 systems that include HASP, after the job has terminated and all 
SYSOUT output that pertains to a job and all output writer records have been 
written, control is passed to the final user written exit routine. 



Event Recording 



Some types of information are recorded whenever particular situations arise. These 
types of information and the situations that cause their recording are: 

• Data set information, which is recorded whenever a data set opened by a user 
program is scratched, renamed, closed, or processed by end of volume (EOV). 

• Direct access volume information, which is recorded (1) for online, direct access 
devices at IPL, (2) when a volume is demounted, and (3) for online, direct access 
devices when a HALT EOD or SWITCH command is issued. 

• Configuration information, which is recorded when a DEFINE, VARY OFFLINE, or 
VARY ONLINE command is issued and after allocation recovery. 

• System statistics, which are generally recorded at the end of every ten minutes of 
elapsed system time and at the end of the day. 

Just as some types of information are recorded whenever particular situations arise, 
some types of exits are entered whenever particular situations arise. These types of 
exits and the situations that cause them to be entered are: 

• Time limit exit, which is entered whenever the step CPU, job CPU, or continuous 
wait time limits are reached. 

• SYSOUT limit exit in VSl, which is entered whenever the OUTLIM limit is reached. 

• SMF record exit in VS2, which is entered whenever an SMF record is ready to be 
written. 



Dumping 



Records are written to the primary SMF data set (SYSl.MANX) until the end of the 
allocated extent is reached. When the end of the allocated extent is reached, SMF 
opens the alternate SMF data set (SYSl.MANY) and continues recording. The 
operator is then notified to use the SMF dump program to copy SYSl.MANX to a 
dump data set. 

Note: If the operator failed to dump the requested SMF data set within a reasonable 
period of time, it is possible for the alternate SMF data set to also become full. When 
this occurs and the SMF buffer also fills, SMF will be in a data lost condition until 
dumping takes place. 

Similar recording and copying operations continue throughout the work day, with 
SMF adding special records whenever a VARY command or allocation recovery 
changes the system configuration and, at the end of specific intervals, to record 
system statistics, such as wait time. The HALT EOD and SWITCH SMF command 
from the operator cause the system statistics to be recorded and the SMF buffers to 
be emptied into the active SMF data set. This active data set is then closed and the 
previously inactive data set is made active and selected for recording. The SMF dump 
program may then be used to copy the inactive SMF data set to the dump data set, 
which contains a complete history of the day's processing. The dump data set can 
serve as input to the user written analysis and report routines, which may be 
executed as ordinary problem programs under the operating system. 



Post Processing 



A user written routine may be used to list and total the system usage by account 
number. A separate analysis program can process the SMF records in the order 
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recorded, to detect excessive system wait time or inefficient use of input/output 
devices. This information can lead to improved system throughput by suggesting 
changes in the job mixture or device allocation. 



Compatibility 



The compatibility between SMF under vsi and MFT, VS2 and MVT, and VS1 and VS2 
is discussed in the following sections. 



SMF Compatibility Between VS1 and MFT 

vsi SMF is compatible with MFT SMF with the following exceptions: 

• SYS l. MANX may not reside on tape for VSI SMF. 

• Two new exits, IEFUIV and lEFUJP, have been added for VSI SMF. 

• The value received in any given field when operating under VSI may differ from 
the value received when operating under MFT. 

• Several record types have been modified for vsi SMF. Figure 6 lists the record 
types and the corresponding modifications. 

I • The RES records 43-45 and 47-49 have been added for VSI. 



Record Types 


Modifications 


Header 


System indicator added. 





Size of virtual storage replaces size of main storage. Size of real storage 
added. 


1 


Paging statistics and time of end of interval added. 


4 


Partition size replaces allocation for hierarchy 0. Storage used replaces 
hierarchy storage used. Reserved fields replace hierarchy 1 fields. No 
device entry for spooled data sets. Step termination indicators and paging 
statistics added. 


5 


In job termination indicator, the ABEND bit turns on when any step 
abnormally terminates. The job completion code field contains the ABEND 
code for the last step that abnormally terminated, regardless of normal 
processing by successive steps. Reserved field replaces checkpoint/restart 
field. A user's logon identifier has been added. 


6 


A user's logon identifier has been added. 


12 


Paging statistics and time of end of collection period added. 


13 


Entry size increased by 12 bytes. 



Figure 6. Record Modifications from MFT for VSI 

SMF Compatibility Between VS2 and MVT 

VS2 SMF is compatible with MVT SMF with the following exceptions: 

• SMF is standard in VS2. 

• SYS I.MANX may not reside on tape for VS2 SMF. 

• Two new exits, IEFU83 and lEFUJP, have been added for VS2 SMF. IEFUJP is 
available only in VS2 systems that include HASP. 

• Record type 26 has been added in a VS2 system with HASP. 

• One exit, IEFUSO, is not available in VS2 SMF. 
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• The value received in any given field when operating under VS2 may differ from 
the value received when operating under MVT. 

• Several record types have been modified for VS2 SMF. Figure 7 lists the record 
types and the corresponding modifications. 



Record Types 


Modifications 


Header 


System indicator added. 





Size of virtual storage replaces size of main storage. Size of real storage 
added. 


1 


Paging statistics and time of end of interval added. . 


4 


Region size replaces allocation for hierarchy 0. Storage used replaces 
hierarchy storage used. Reserved fields replace hierarchy 1 fields. Step 
termination indicators and paging statistics added. 


5 


Reserved field replaces checkpoint/restart field. 


6 


Additional HASP fields have been added for VS2 systems with HASP. 


12 


Paging statistics and time of end of collection period added. 


30 


Contains some of the fields that are in record type 38 in an MVT system. 
(Record type 38 is not produced in VS2.) 


41 


Contains some of the fields that are in record type 38 in an MVT system. 



Figure 7. Record Modifications from MVT for VS2 

SMF Compatibility Between VS1 and VS2 

VSl SMF is compatible with VS2 SMF with the following exceptions: 

• For VSl, SMF is optional; for VS2, SMF is standard. 

• In VS2, SMF can be used on both batch (background) jobs and time sharing 
(foreground) jobs entered from a terminal with the time sharing option (TSO); in 
vsi, smf can be used only on batch (background) jobs. 

• Exits that are available only in VSl are IEFUIV and IEFUSO; the exit that is 
available only in VS2 is IEFU83. 

• Record types 13, 43-45, and 47-49 are written only in VSl systems; record types 
26, 30-35 and 40-42 are written only in VS2 systems. 

• Several record types have additional fields for VS2. Figure 8 lists the record types 
and the corresponding modifications. 

• IEFUJP exit in VSl points to accounting information; IEFUJP exit in VS2 with HASP 
points to record type 26. 

• Record type 26 is written only in VS2 systems with HASP. 



Record Types 


Modifications 


1 


More system statistics added. 


4 


Device entries for spooled data sets have been added. 


5 


A user's logon identifier has been added in VSl; it is reserved in VS2. 


6 


A user's logon identifier has been added in VSl. In a VS2 system with HASP, 
additional fields have been added. 


12 


More system statistics have been added. 



Figure 8. Record Modifications from VSl for VS2 
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Incorporating SMF into the Operating System 



SMF is specified when you generate your VSl operating system. SMF is a standard 
function in a VS2 system. 

For VSl, SMF is an optional part of the system. To add SMF to your VSl operating 
system, you must include SMF in the system generation statements. 

If you are going to record data in either VSl or VS2, you must define your use of 
SMF either in smfdeflt or from the operator's console, allocate direct access space 
for the SMF data set, and add any user written exit routines you want to the control 
program. The information needed to add SMF to the system is given in the topics 
that follow. 



Including Exit Routines in the System 



Exit routines are an optional feature of SMF. If you decide to use exit routines, we 
suggest you incorporate them into system library SYS1.AOS00 before you generate 
your system. Otherwise, they must be link-edited into the appropriate system load 
module. (For a discussion of adding the IEFUJP exit to HASP, refer to OS/ VSl 
HASP II (V.4) Systems Programmer's Guide, GC27-6992.) 

Note: If an exit routine is link-edited into an active system, a link-edit failure may 
render inoperative the load modules into which the exit was being link-edited. This 
is particularly important in the case of termination exits, because a failure would 
result in the loss of the output that indicates the cause of failure. 

Figure 9 illustrates the JCL required to add exit routines to SYS1.AOS00 prior to 
system generation. If you do not require all exit routines in your system, simply omit 
the object deck and NAME control statement for those you do not need. 

If you wish to add or replace exit routines after system generation, you must 
link-edit the routines into the appropriate load module. Figure 10 shows the load 
module assignments. 

When adding exit routines after system generation in either VSl or VS2, refer to your 
system generation listing for exact load module names and aliases. 

Figure 11 shows the JCL required to add exit routines to SYS1.LINKLIB after 
generating a VSl system. 

Figure 12 shows the JCL required to add the exit routine IEFUTL to SYS1. NUCLEUS 
after generating a VSl system. 

Figure 13 shows the JCL required to add exit routines to SYS1.LPALIB after 
generating a VS2 system. 
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//EXITLNK JOB 123456, SMITH 

// EXEC PGM=IEWL,PARM=( DC, LET, LIST, RENT, NCAL ) 

//SYSPRINT DD SYSOUT=A 

//SYSLMOD DD DSNAME=SYS1 .AOS00 ,DISP=( OLD, KEEP ) 

//SYSUT1 DD UNIT=SYSDA,DISP=( , DELETE ) , SPACE=( TRK, ( 20,5 ) ) 

//SYSLIN DD * 

(IEFUIV object deck)' 

NAME IEFUIV( R ) 
(IEFUJV object deck) 

NAME IEFUJV( R ) 
(IEFUJI object deck) 

NAME IEFUJI(R) 
(IEFUSI object deck) 

NAME IEFUSI(R) 
(IEFUSO object deck)' 

NAME IEFUSO( R ) 
(IEFUTL object deck) 

NAME IEFUTL(R) 
IEFU83 object deck) 2 

NAME IEFU83(R) 
(IEFACTRT object deck) 

NAME IEFACTRT(R) 

| (IEFUJP object deck) 3 

NAME IEFUJP(R) 
/* 

1 This exit is available only in VS1. 

2 This exit is available only in VS2. 

| 3 This exit is available in vsi and in VS2 systems that include HASP. 

Figure 9. JCL for Adding Exit Routines to SYS1.AOS00 Prior to System Generation 





Object module for 
this exit routine 


Must be link-edited into this load 
module in VSI 


Must be link-edited into this 
load module in VS2 


IEFUIV 


IEFJESinSYSI.LINKLIB 


Not applicable 


IEFUJV 


IEFUJV in SYS1.LINKLIB 


IEFUJV in SYS1.LPALIB 


IEFUJI 


IEFSD162 in SYS1.LINKLIB 


IEFSD061 in SYS1.LPALIB 


IEFUSI 


IEFSD162 in SYS1.LINKLIB 


IEFSD061 inSYSI.LPALIB 


IEFUSO 


IEFJESinSYSI.LINKLIB 


Not applicable 


IEFUTL 


IEANUC01 inSYSI.NUCLEUS 


IEFSD263 in SYS1.LPALIB 


IEFU83 


Not applicable 


IEFU83 inSYSI.LPALIB 


IEFACTRT 


IEFSD161 in SYS1.LINKLIB 1 
IEFW21SD in SYS1.LINKLIB 2 


IEFSD061 in SYS1.LPALIB 


IEFUJP 


IEFJESinSYSI.LINKLIB 


HASP in HASP library 



1 iefactrt must be link-edited into this load module if either smf=basic or smf=full is 
specified. 

2 iefactrt must also be link-edited into this load module if SMF=basic is specified. 
Figure 10. Required Load Module Assignments for Exit Routines 



28 OS/VS System Management Facilities (SMF) 



//EXITLNK JOB 123456, SMITH 

//STEP1 EXEC PGM=IEWL,PARM=(LET,LIST,NCAL,XREF) 

//SYSPRINT DD SYSOUT=A 

//SYSLMOD DD DSNAME=SYS1 . LINKLIB,DISP=( OLD, KEEP ) 

//SYSUT1 DD UNIT=SYSDA,DISP=( , DELETE ) , SPACE=( TRK, ( 20,5) ) 

//SYSLIN DD * 

(IEFUJV object deck) 

ENTRY IEFUJV 

INCLUDE SYSLMOD( IEFUJV) 

NAME IEFUJV( R ) 

(IEFUJI and IEFUSI object decks) 

ENTRY IEFSD062 

INCLUDE SYSLMOD( I.EFSD1 62 ) 

ALIAS IEFSD62A,IEFALRET 

NAME IEFSD162(R) 

| (IEFACTRT object deck) 1 

ENTRY IEFSD061 

INCLUDE SYSLMOD( IEFSD161 ) 

ALIAS IEFSD065,IEFW42SD,GO 

ALIAS IEFSDA66 , IEFV422 1 , IEFIRET 

NAME IEFSD16KR) 
//STEP2 EXEC PGM=IEWL,PARM=( NCAL, LIST, XREF, LET, RENT) 
//SYSPRINT DD SYSOUT=A 

//SYSLMOD DD DSNAME=SYS1 . LINKLIB,DISP=( OLD, KEEP ) 
//SYSUT1 DD UNIT=SYSDA,DISP=( , DELETE ) , SPACE=( TRK, ( 20,5 ) ) 
//SYSLIN DD * 

(IEFUSO, IEFUIV, and IEFUJP object deck) 

ENTRY IEFJESCT 
INCLUDE SYSLMOD( IEFJES ) 
NAME IEFJES(R) 



/* 



When smf=basic is specified, iefactrt must also be link-edited in load module IEFW21SD. 
The required statements for this additional link-edit are as follows: 



ENTRY 


IEFJESCT 


INCLUDE 


SYSLMOD (IEFW21SD) 


ALIAS 


IEFVM1 ,IEFXA,IEFMCVOL 


NAME 


IEFW21SD(R) 



Figure 11. JCL for Adding Exit Routines to SYS1.LINKLIB After Generating 
a VS1 System 



//NUCLINK JOB 123456, SMITH 

// EXEC PGM=IEWL,PARM=(SCTR, LET, LIST, NCAL, XREF) 

//SYSPRINT DD SYSOUT=A 

//SYSLMOD DD DSN=SYS 1 .NUCLEUS , DISP=OLD 

//SYSUT1 DD UNIT=SYSDA,SPACE=(CYL,( 2,2 ) ) 

//SYSLIN DD * 

INSERT IEAAIH00 

INSERT IEAIOS00 

INSERT IEAASNT2 

Additional INSERT statements required 1 

(IEFUTL object deck) 

INCLUDE SYSLMOD( IEANUC01 ) 
NAME IEANUCOKR) 
/* 

1 These insert statements are variable according to your SYSGEN; therefore, refer to your 
SYSGEN listing for link edit of SYS1.NUCLEUS and copy the INSERT statements as found there. 

Figure 12. JCL for Adding IEFUTL to SYS1. NUCLEUS After Generating 
a VS1 System 
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//LINKEXIT JOB 1 23456 , JONES ,REGION=300K 

//STEP1 EXEC PGM=IEWL, 

// PARM='LET, LIST, RENT, NCAL, XREF,REFR, SIZE=( 250K,30K)' 

//SYSPRINT DD SYSOUT=A 

//SYSLMOD DD DISP=( OLD, KEEP ), DSN=SYS1 . LPALIB 

//SYSUT1 DD UNIT=SYSDA,DISP=( , DELETE), 

// SPACE=(TRK,( 20,5 ) ) 

//SYSLIN DD * 

ENTRY IEFUJV 

(IEFUJV object deck) 

NAME 
ENTRY 

(IEFUTL object deck) 

INCLUDE 
NAME 
//STEP2 

// 

//SYSPRINT 
//SYSLMOD 
//SYSUT1 

// 

//SYSLIN 
ENTRY 



IEFUJV(R) 
IEFSD263 



SYSLMOD( IEFSD263 ) 

IEFSD263(R) 

EXEC PGM=IEWL, 

PARM=, ' LET , LIST , RENT , NCAL, XREF , SIZE=( 250K , 30K ) ' 

DD SYSOUT=A 

DD DISP=( OLD, KEEP ),DSN=SYS1 .LPALIB 

DD UNIT=SYSDA,DISP=( , DELETE), 

SPACE=(TRK,( 20,5 ) ) 

DD * 

IEFSD061 



(IEFUJI, IEFUSI, and IEFACTRT object decks) 



INCLUDE 
ALIAS 
NAME 
ENTRY 



SYSLMOD( IEFSD061 ) 
IEFSD064,IEFSD104 
IEFSD06KR) 
IEFU83 



IEFW42SD 



(IEFU83 

NAME 
/* 



object 



deck) 

IEFU83I 



R) 



Figure 13. JCL for Adding Exit Routines to SYS1. LPALIB After Generating 
a VS2 System 



SYSGEN Procedure 



One system generation macro instruction, SCHEDULR, is specifically related to SMF. 
In either VSl or VS2, the parameters you supply for the SCHEDULR macro 
instruction depend on your installation requirements. For example, if you require 
record type 21 to be written, the ESV parameter of the SCHEDULR macro instruction 
must specify SMF. If you are recording, the value of the JOBQLMT parameter in the 
SCHEDULR macro instruction must be increased to include two additional messages 
per job and per job step and additional system queue space must be specified in the 
CTRLPROG macro instruction (using the SYSQUE parameter for VSl or the QSPACE 
parameter for VS2). 

One system generation macro instruction, JES, is related to SMF in VSl. Specifically, 
the VSl exit IEFUSO is related to the OUTLIM parameter of this macro instruction. 

Additional SYSGEN requirements must be fulfilled to add RES or TSO to your 
system. For a complete discussion of the system generation procedure, refer to 
OS /VSl System Generation Reference, GC26-3791, and OS/ VS2 System 
Generation Reference, GC26-3792. 

In VSl, you may specify in the SCHEDULR macro instruction one of the following: 

• SMF=NOTSUPPLlED, which specifies that no SMF processing is to be provided. If 
the SMF parameter is not coded and the ESV parameter of the SCHEDULR macro 
does not specify SMF, NOTSUPPL1ED is the default. 
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• SMF=BASIC, which specifies that user written accounting routines, Job Entry 
Subsystem (JES) accounting information, and exits IEFUSO, IEFUJP, and 



IEFACTRT are to be provided. No SMF records are generated. For further 
information on handling accounting information when SMF=BASIC is specified, 
refer to OS/VS1 Planning and Use Guide , GC24-5090. 

• SMF=FULL, which specifies that the SMF routines, additional JES accounting 
information, and exits IEFUIV, IEFUJV, IEFUJI, IEFUSI, IEFUSO, IEFUTL, 
IEFACTRT, and IEFUJP are to be provided. If the SMF parameter is not coded and 
the ESV parameter specifies SMF, FULL is the default. 

Figure 1 4 provides more detailed information about the availability of exits in VS 1 
when BASIC or FULL is coded. 
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Figure 14. Availability of Optional Exits Supported by SMF in VS1 
When BASIC or FULL Is Coded 

The OUTLIM function, which limits the number of logical records written to 
non-direct SYSOUT data sets, is always supported in VS1. The IEFUSO exit, which 
can be used to override the output limit, is supported if BASIC or FULL is coded. 



Defining Use of SMF for Both VS1 and VS2 Systems 



The way you intend to use SMF for both VSl when SMF=FULL is specified and for 
VS2 is defined through SMFDEFLT. SMFDEFLT parameters can be grouped as 
follows: 

• Required parameters, which must always be included and specify the job wait 
time limit and the system on which SMF is active. 

• Optional parameters, which include parameters to select record types, to specify 
physical information about the data sets, to permit operator modification, and to 
specify whether exits are to be taken. 

SMFDEFLT parameters can be specified either (1) before the first IPL of a newly 
generated system by adding SMFDEFLT as a member in SYS1.PARMLIB, (2) at each 
initialization of SMF by entering SMFDEFLT parameters at the console during IPL, or 
(3) in VSl only, by the setup and subsequent use of the Automated System 
Initialization facility (see VSl Release 2 Guide , GC24-5097). However, note that 
if a job is recovered in a warm start, the setting of six parameters (SID, MDL, OPT, 
DSV, rec, and EXT) will be the setting in effect when the job was read in, rather 
than the setting done during the warm start IPL. See "Entering SMFDEFLT into 
SYS1.PARMLIB" later in this chapter for information on coding and entering 
SMFDEFLT parameters. 
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Required Parameters 



JWT Parameter 



SID Parameter 



MDL Parameter 



The system is distributed with an SMFDEFLT parameter list. These parameters for 
VS2 are shown in Figure 15. The parameters are the same for VS1 except for SID and 
MDL. (In VSl, SID is equal to 4A and MDL is equal to 45.) You should modify this 
list according to your system requirements. For example, for the PRM and ALT 
parameters, you should specify the volume serial number of the volume on which 
you are recording. 

0PT=2 , EXT=YES , SID=H1 , BUF=2000 , JWT=1 ,MDL=55 , 
OPI=YES , MAN=ALL , PRM=SYSSMF , ALT=SYSSMF 

Figure 15. Parameters in the Sample SMFDEFLT Data Set 



Three of the SMFDEFLT parameters are required in order to run SMF in a VS2 system 
or in a VSl system where SMF=FULL is specified. These three parameters, described 
in the topics that follow, are: 

• JWT, which specifies the job wait time limit. 

• SID, which identifies the system on which SMF is active. 

• MDL, which defines the model identifier of the system on which SMF is active. 



The JWT parameter is a required parameter that specifies the number of minutes a 
job is allowed to remain continuously in the wait state. When the specified limit has 
been reached, the time limit exit (IEFUTL) is entered if exits are to be taken. 

The format of the JWT parameter is: 

where: 

n 

represents a decimal number containing a maximum of three digits. It specifies 
the number of minutes that is the continuous wait time limit for jobs in the 
system. The value specified must be greater than 0. 



The SID parameter is a required parameter that identifies the system on which SMF 
is active. 

The format of the SID parameter is: 

where: 

xx 

represents two alphameric characters identifying the system on which SMF is 
active. 

Note: The information specified by the SID and MDL parameters is treated as one 
field in SMF records. Therefore, the last character of the SID parameter may be 
considered to be the first character of a three-character MDL specification. 



The MDL parameter is a required parameter that defines the user-supplied model 
identifier of the system. 
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The format of the MDL parameter is: 

MDL= xx 1, 



Optional Parameters 



MAN Parameter 



where: 

xx 

represents two alphameric characters selected by the user to identify the model of 
his system. 

Note: The information specified by the SID and MDL parameters is treated as one 
field in SMF records. Therefore, if you want to specify three digits for the MDL 
parameter, enter the first digit as the last digit of the SID parameter. For example, if 
the system identification is "B" and the model is "145," specify SID =B1 and 

MDL=45. 



Nine of the SMFDEFLT parameters are optional. The optional parameters used to 
select record types are: 

• MAN, which specifies the type of records (all, none, or only user) to be written to 
the SMF data set. 

• OPT, which specifies the type of system, job, and job step information to be 
collected. 

• DSV, which specifies the type of data set information and/or direct access volume 
information to be collected. 

• REC, which specifies whether or not temporary data set information is to be 
collected. 

The optional parameters used to specify physical information about the data sets 
are: 

• BUF, which specifies the size of the SMF buffer. 

• PRM, which specifies the primary SMF data set. 

• ALT, which specifies the alternate SMF data set. 
The other two optional parameters are: 

• OPI, which specifies whether or not the operator is allowed to modify parameters. 

• EXT, which specifies whether or not exits will be taken. 



The MAN parameter is an optional parameter that specifies the type of records to be 
written to the SMF data set. This parameter must be specified as man=all or 
MAN=USER if records are to be written to the SMF data set. If MAN is equal to ALL 
or USER, the parameters BUF, PRM, and ALT are required. If records are going to be 
written only to an installation-defined data set, the parameter may be specified as 
MAN=NONE. If MAN is equal to NONE, the OPT, DSV, and REC parameters have no 
function and user exits cannot write to the SMF data set. 

The format of the MAN parameter is: 

[MAN={NONE | USER | ALL} ] 

where: 

NONE 

specifies that no records are to be written to the SMF data set. 
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OPT Parameter 



DSV Parameter 



USER 

specifies that only user records (from user written exit routines) are to be written 
to the SMF data set (that is, only record types 128 through 255 are written). 

ALL 

specifies that both SMF and user records are to be written to the SMF data set. If 
the parameter is omitted, ALL is assumed. 

If MAN=NONE is specified, no records are written to the SMF data set, regardless of 
the values specified in the OPT, DSV and REC parameters. If MAN=ALL is specified, 
all SMF records are created, unless suppressed by the OPT, DSV, or REC parameters. 
All of the records created are written unless suppressed by a user written exit 
routine. 



The OPT parameter is an optional parameter that specifies the type of system, job, 
and job step information to be collected by SMF. 

The format of the OPT parameter is: 

where: 

1 

specifies that only system and job information is to be collected by SMF (that is, 
record type 4, which contains job step information, is suppressed) and that the 
step-related exit, IEFUSI, is not taken. 

2 

specifies that system, job, and job step information is to be collected by SMF. If 
the OPT parameter is omitted, 2 is assumed. 

Note: If OPT=l is specified, and if DSV=2 or DSV=3 is also specified, the value 
OPT=2 is used instead of OPT=l and message IEE359I is produced. 



The DSV parameter is an optional parameter that specifies the type of data set 
information and/or direct access volume information to be collected by SMF. 

The format of the DSV parameter is: 
where: 







specifies that neither data set information nor direct access volume information is 
to be collected by SMF (that is, record types 14, 15, and 17-20, which contain 
data set information and direct access volume information, are suppressed). If the 
parameter is omitted, is assumed. 

specifies that direct access volume information (record type 19) is to be collected 
by SMF and record types 14, 15, 17, 18, and 20, which contain data set 
information, are suppressed. 
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specifies that data set information (record types 14, 15, 17, 18, and 20) is to be 



collected by SMF and record type 19, which contains direct access volume 
information, is suppressed. 



REC Parameter 



BUF Parameter 



specifies that both data set information and direct access volume information 
(record types 14, 15, and 17-20) is to be collected by SMF. 

Note: If OPT=l is specified, and if DSV=2 or DSV=3 is also specified, the value 
OPT=2 is used instead of OPT=i, and message IEE359I is produced. 



The REC parameter is an optional parameter that specifies whether record type 17 
will be written for temporary data sets. ' This parameter is not functional unless you 
have specified DSV=2 or DSV==3. 

The format of the REC parameter is: 

[REC={0|2}] 

where: 







specifies that record type 17 is to be written for only non-temporary data sets 
and is to be suppressed for temporary data sets. If the parameter is omitted, is 
assumed. 

specifies that record type 17 is to be written for temporary data sets as well as for 
non-temporary data sets. 



The BUF parameter is an optional parameter that specifies the size of the SMF 
buffer. This parameter must be specified if the MAN parameter is specified as 
MAN=ALL or MAN=USER. If neither SMF records nor user records are to be 
recorded, this parameter is not required. Buffer size requirements are discussed in 
"System and Partition Queue Areas" in the chapter "System Information and 
Requirements." 

The format of the BUF parameter is: 

where: 

n 

represents a decimal number containing three to four digits. The number defines 
the size (in bytes) of the SMF buffer. Minimum buffer size is 400 bytes; 
maximum buffer size is 8,192 bytes. If the value is not a multiple of 8, it is 
rounded to the next lower multiple of 8. 

Note: You must dump the SMF data set(s) before you reduce the buffer size from 
the size specified at the previous IPL; otherwise, the SMF data set cannot be 
retrieved successfully. 



The system determines that a data set is temporary if it has a system generated name and is 
created within a job or job step and exists only for the duration of that job or job step. The 
system generates a name when the DD statement for a new data set does not include the 
dsname parameter, or when it contains a parameter of the form DSNAME=&name or 
DSNAME=&&name. 
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PRM Parameter 



ALT Parameter 



OPI Parameter 



The PRM parameter specifies the primary SMF data set (SYS1.MANX). This 
parameter must be specified if the MAN parameter is specified as MAN=ALL or 
MAN=USER. If neither SMF records nor user records are to be recorded, this 
parameter is not required. 

The format of the PRM parameter is: 

PRM= { vol.ser.no. } 

where: 

vol. ser.no. 

represents one to six alphameric characters specifying the serial number of the 
direct access volume on which the SYS I.MANX data set resides. 

dev.addr. 

represents three alphameric characters specifying the address of the device on 
which the volume containing the SYS1.MANX data set is mounted. 



The ALT parameter specifies the alternate SMF data set (SYS l. MANY). This data set 
must be defined on the same type of direct access device as the primary data set 
(SYS l. MANX). This parameter must be specified if the MAN parameter is specified as 
MAN=ALL or MAN=USER. If neither SMF records nor user records are to be 
recorded, this parameter is not required. 

The format of the ALT parameter is: 

ALT= { vol.ser.no. } 

where: 

vol.ser.no. 

represents one to six alphameric characters specifying the serial number of the 
direct access volume on which the SYS 1. MANY data set resides. 

dev.addr. 

represents three alphameric characters specifying the address of the device on 
which the volume containing the SYSl.MANY data set is mounted. 



The OPI parameter is an optional parameter that specifies whether the operator will 
be permitted to modify SMFDEFLT parameters from the console during I PL. The OPI 
parameter is ignored if it is entered from the console. 

The format of the OPI parameter is: 

where: 
YES 



specifies that the operator is allowed to modify parameters. 



NO 



specifies that the operator is not allowed to modify parameters. If the parameter 
is omitted, NO is assumed. 
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EXT Parameter 



The, fvt parameter is an optional parameter that specifies whether the SMF exits, 



with the exception of the vsi exit IEFUSO, are to be taken. This parameter is 
independent of the value specified for the MAN parameter. (The IEFUSO exit is 
taken when the OUTLIM limit is reached for VSI systems generated with the 
SCHEDULR macro instruction keyword SMF=BASIC or SMF=FULL.) 

The format of the EXT parameter is: 

[EXT={YES|NO}] 

where: 

YES 

specifies that exits are to be taken. If the parameter is omitted, YES is assumed. 

NO 

specifies that exits are not to be taken. 

If EXT=YES is specified, the exits actually taken will depend on the data-collection 
parameter (OPT). If OPT=2 is specified, all exits defined for the system will be taken; 
if OPT=l is specified, the job step initiation exit and job step termination exit will 
not be taken. 

Selecting SMF Records Using SMFDEFLT Parameters 

Figure 16 summarizes the use of the SMFDEFLT parameters to select SMF records. 



Keyword 


Value 


Meaning 


Effect on SMF Records 


MAN 


ALL 


All SMF records. 


Record types through 255 may be 
written to the SMF data set. 


NONE 


No SMF records. 


The SMF data set is not used. 


USER 


Only user-formatted SMF 
records. 


Only record types 128 through 255 may 
be written to the SMF data set. 


OPT 


1 


System and job 
information. 


Record types 0-3, 5-13, 26 (in a VS2 
system with HASP), 43-45, and 47-49 are 
created, but record type 4 is suppressed. 
Messages IEF375I and IEF376I are 
provided. 


2 


System, job, and job step 
information. 


Record types 0-13, 26 (in a VS2 system 
with HASP), 43-45, and 47-49 are created, 
and messages IEF373I through IEF376I are 
provided. 


DSV 





No information for data 
sets or direct access 
volumes. 


Record types 14, 15, and 17 through 20 
are suppressed. 


1 


Direct access volume 
information. 


Record type 19 is created, but record 
types 14, 15, 17, 18, and 20 are 
suppressed. 


2 


Data set information. 1 


Record types 14, 15, 17, 18, and 20 are 
created, but record type 19 is suppressed. 


3 


Data set and direct access 
information. 1 


Record types 14, 15, and 17 through 20 
are created. 


REC 





No information for 
temporary data sets. 


Record type 17 is created for 
non-temporary data sets only. 


2 


Temporary data set 
information. 


Record type 17 is created for temporary 
data sets as well as for non-temporary 
data sets. 



1 OPT must equal 2 if DSV is 2 or 3. If OPT equals 1 and DSV equals 2 or 3, the value OPT=2 is 
substituted. 

Figure 16. Summary of the Use of SMFDEFLT Parameters to Select SMF Records 
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Specifying SMF Parameters for TSO (VS2 Only) 

When SMF is present in a system that has Time Sharing Option (TSO), SMF 
information and exits are available for the TSO jobs. The SMF parameters for TSO 
can be defaulted or can be specified separately. The defaults for a START TS 
command are the parameter values in effect for the background. The defaults for a 
MODIFY TS command are the parameter values in effect for the foreground. The 
options for TSO are separately specified by (1) adding the TSO SMF parameters to 
any member in SYS1.PARMLIB and referencing the member on a START TS command 
or (2) overriding the TSO-related background parameters in a START TS or MODIFY 
TS command if operator intervention is specified in the SMFDEFLT member. 

The format of the SMF options that can be specified for TSO is: 
SMF=({OFF | OPT=l | OPT=2MEXT=YES I EXT=NO}) 

where: 

OFF 

specifies that only TSO system records (types 30 through 33, 41, and 42) are to 
be generated. 

OPT=l 

specifies that TSO system and step (session) records are to be written and that 
job-level exits are to be taken if EXT=YES is specified. TSO step records (types 34 
and 40) are not to be written and step-level exits are not to be taken. 

OPT=2 

specifies that TSO system, session, and step records are to be written. Both job 
and step-level exits are to be taken if EXT=YES is specified. 

EXT=YES 

specifies that user exits allowed by the value specified in OPT are to be taken 
from TSO jobs. 

EXT=NO 

specifies that user exits are not to be taken from TSO jobs, regardless of what is 
indicated in the OPT field. 

The OPT and EXT parameters for TSO jobs are separate from the same parameters 
for background jobs. However, the options assigned for TSO cannot be more 
comprehensive than those specified for background jobs; for example, if job step 
records are not written for background jobs, they are not written for TSO jobs. 

Note: If DSV=2 or DSV=3 is specified for the background, OPT=2 must be specified 
for the foreground. If OPT=l is requested for the foreground, OPT=2 is substituted. 

Figure 17 shows the interaction of values specified for background and TSO jobs. 
The values assigned for background jobs are not affected by values assigned for TSO 
jobs. 



Background Value 


TSO Value Requested 


TSO Value Assigned 


OPT=1 


OPT=l 


OPT=l 


OPT=1 


OPT=2 


OPT=1 


OPT=2 


OPT=1 


OPT=1 


OPT=2 


OPT=2 


OPT=2 


EXT^YES 


EXT=YES 


EXT=YES 


EXT=YES 


EXT=NO 


EXT=NO 


EXT=NO 


EXT=YES 


EXT=NO 


EXT=NO 


EXT=NO 


EXT=NO 



Figure 17. Interaction of OPT and EXT Values Specified for Background and TSO 
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Selecting SMF Records Using TSO Parameters (VS2 Only) 

You can also select typos of r e cords to be written to the SMF data set through the 



use of TSO parameters OPT and OFF when operating SMF in VS2. Figure 18 
summarizes the use of the TSO parameters to select SMF records. 



Keyword 


Value 


Meaning 


Effect on SMF Records 


OPT 


1 


TSO system and session 
records. 


Record types 30-33, 35, and 41-42 are 
created, but record types 34 and 40 are 
suppressed. 


2 


TSO system, session, and 
step records. 


Record types 30-35, and 40-42 are 
created. 


OFF 




TSO system records. 


Record types 30-33, 41 , and 42 are 
created, but record types 34, 35, and 40 
are suppressed. 



Figure 18. Summary of the Use of TSO Parameters to Select SMF Records 

Entering SMFDEFLT into SYS1.PARMLIB 

SMFDEFLT consists of a series of parameters contained in 80-character, card-image 
records. When you have determined the parameters for SMFDEFLT, you must have 
them punched into a card deck and added as a member of SYS1.PARMLIB. 

Each parameter has the format: 

keyword= {value | ( value „ value 2 ,..., value n ) } 

When punching the parameters into a card deck, consecutive parameters are 
separated by commas and no embedded blanks are permitted. Although parameters 
may be included in any order, you must conform to the following restrictions in 
coding SMFDEFLT parameters: 

• Parameters cannot be placed in columns 72 through 80; these columns are 
ignored. 

• Continuation of statements must be indicated by placing a blank character after 
the delimiting comma and before column 72. (All records in the member except 
the last one indicate continuation.) 

• A parameter cannot be divided between two records. Each set of parameter and 
value must be complete within a single record. 

You should add the SMFDEFLT card deck as a member of SYS1.PARMLIB by 
executing the IEBUPDTE utility program. Figure 19 illustrates the JCL required to 
execute the utility program. 

If your parameters change, you may replace the entire SMFDEFLT member with a 
new version by again executing IEBUPDTE. For information on the IEBUPDTE 
program, refer to OS/ VS Utilities, GC35-0005. 

If operator intervention is allowed (OPl=YES), you may change SMFDEFLT 
parameter values from the operator's console during I PL. If parameter errors occur, 
the operator is prompted for correct parameters regardless of the value specified for 
OPI. 



Incorporating SMF into the Operating System 39 



//ENTER JOB 123456, SMITH 

// EXEC PGM=IEBUPDTE,PARM=NEW 

//SYSPRINT DD SYSOUT=A 

//SYSUT2 DD DSNAME=SYS1 . PARMLIB,DISP=( OLD, KEEP)' 

//SYSIN DD DATA 

./ ADD LIST=ALL,NAME=SMFDEFLT,LEVEL=01 ,SOURCE=0 

(SMFDEFLT data set) 

/* 

1 If you want to access SMFDEFLT on the distribution package before generating your system, the 
data set name is SYS1.APARMLIB. 

Figure 19. JCL Required for Entering SMFDEFLT into SYS1.PARMLIB 
Using IEBUPDTE 

Note: If you do not have SMFDEFLT as a member in SYS1.PARMLIB, the parameters 
must be entered from the operator's console during ipl. 
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System Information and Requirements 



To effectively plan for and use SMF, you must have knowledge of system 
requirements (including main and auxiliary storage requirements), of system 
throughput and performance options, and of operational considerations. These 
topics are discussed in the remainder of this chapter. 



System Requirements 

SMF requires additional main storage, and it requires auxiliary storage. 

Main Storage Requirements 

SMF requires additional main storage space for the VS1 nucleus, the system queue 
area, and, if exit routines are included, space for system tasks. 

Nucleus and System Link Pack Areas 

The storage required for the VS1 nucleus is 2,300 bytes plus 148 bytes for each 
partition. An additional 1,560 byte area is required in the VS1 pageable nucleus and 
in the VS2 pageable system link pack area for the SMF writer routine. 

System and Partition Queue Areas 

Main storage is required in both VS1 and VS2 for the Timing Control Table (TCT), 
System Management Control Area (SMC A), the common parameter area for user 
written exit routines, and the SMF buffer. Figure 20 shows the areas of each system 
that require the additional storage. 



Item 


VS1 


VS2 


TCT 


Fixed PQA 


Fixed LSQA 


SMCA 


Fixed SOA 


Fixed SQA 


Common Parameter Area 


Fixed PQA 


Fixed LSQA 


SMF Buffer 


Pageable SQA 


Fixed SQA 



Figure 20. System Areas that Require Additional Storage 

One TCT is created for each active job step. If only job accounting is required 
(OPT=l), the size of each TCT is 116 bytes. If job step accounting is required 
(OPT=2), the size of each TCT is determined by the following formula: 

TCT= 132 + 12(a) + 8(Z>) 

where: 

a 

is the maximum number of DD statements per job step. 

b 

is the number of devices allocated because of each DD statement. 

| The SMCA is a permanent table occupying 148 bytes in VS1 and 172 bytes in VS2. 

The area used for communication between user written exit routines is discussed in 
"Exit Routine Facilities and Restrictions" in the chapter "Exit Routines." 

To determine the SMF buffer size required, you must understand how the buffer is 
used. SMF records are blocked internally in variable-length format and, if necessary, 
spanned before they are written to the SMF data set. To allow overlapping of 
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blocking and writing, the buffer size defined by the BUF parameter in SYS1.PARMLIB 
is divided into two equal parts; while one half of the buffer is being filled, the other 
half can be written. 

If records are to be written to the SMF data set, you must supply a buffer size in the 
SMFDEFLT data set before or during I PL. The minimum BUF size is 400 bytes; the 
I maximum is 8,192. The size specified should be twice the size of the largest record 
to be written to the SMF data set to eliminate the need to span records. 1 More than 
one record can be written in half the buffer if record sizes permit, but if a record 
exceeds half the buffer, it is written as segments of a spanned record. To improve 
performance, the SMF buffer size should be defined to eliminate the need to span 
records. Note, however, that if the system fails, any records in the buffer are lost. 
Therefore, do not make the buffer larger than necessary. 

Figure 2 1 shows a list of buffer sizes and the corresponding number of average jobs 
that can be written on single track of various direct access devices. The figures have 
been adjusted to allow for interrecord gaps. See "SMF Data Sets" later in this 
chapter for a sample tabulation of some of the SMF records and their sizes. If you 
plan to reduce the size of the buffer during consecutive IPLs, dump the SMF data 
set(s) by using the SMF dump program (IFASMFDP); otherwise, the SMF data set 
cannot be retrieved successfully. 



Buffer 
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Jobs per Track 


2314 


3330 
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300 
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9.0 
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5.5 


10.0 
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700 


5.5 


10.5 


1,800 


900 


6.0 


10.5 


2,200 


1,100 


5.5 


11.0 


2,600 


1 ,300 


6.5 


11.5 


3,000 


1,500 


6.0 


12.0 


4,000 


2,000 


6.0 


12.0 


6,000 


3,000 


6.0 


12.0 



Figure 21. SMF Buffer Size and Use of Direct Access Space 



Auxiliary Storage Requirements 



SMF requires auxiliary storage for the SMF data sets and the expansion of system 
libraries. 



SMF Data Sets 



The SMF data set must be permanently resident on a direct access device. The ability 
of SMF to record data in time sequence order on SYSl.MANX and SYS1.MANY across 
system failures IPLs, and the dumping of full data sets is based on the assumption 
that the data sets are allocated to the same device types and have the same amount 
of space. Several factors, such as specific system configuration, amount of SMF data 
to be written, and report program requirements, will determine which type of device 
is more efficient for a particular installation. 



The Block Descriptor Word (four bytes) and the Record Descriptor Word (four bytes) should be 
included in the calculation of the largest record size. 
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Space must be allocated for the primary SMF data set (SYS1.MANX) and for an 
alternate SMF data set (SYS1.MANY). The two data sets need not be defined on the 



System Libraries 



Performance 



same physical device, but tney must be of ihe same typ e. Only device types on 

which system resident volumes are supported may be used, but, if possible, a device 
and channel other than those specified for SYSRES should be used. 

The devices used for the data sets are defined in SMFDEFLT and become 
permanently resident at I PL. The devices must be on line and ready during I PL. 
Space for the SMF data sets must be allocated prior to I PL. 

Switching between the primary and alternate data sets is automatic as each becomes 
filled. The SWITCH or HALT command, however, can be used to switch between the 
data sets whenever you choose. The SMF dump program must be used to transfer a 
full data set to tape. When a dump is completed, the status of the data set is reset to 
empty by the dump program. 

The space to be allocated to the SYS I.MANX and SYSl.MANY data sets depends on 
the average amount of data generated by each of your jobs and how often you want 
to dump the alternating data sets. The method for allocating space for SMF data sets 
on direct access devices is shown in "Data Management Procedures" later in this 
chapter. Figure 22 shows the size of some of the records that can appear in an SMF 
data set. 

Figure 23 is an example of how the VS1 space requirements for an entire data set 
can be established, given certain assumptions. Similar calculations can be made for a 
VS2 system. The ESV record (type 21), the Data Lost record (type 7), and RES 
records (types 43-45 and 47-49) are not shown in this example. 



SMF requires direct access device space for expansion of system libraries when exits 
are used. In VS1, the system libraries sysi.linklib and SYS1. NUCLEUS require 
expansion space. In VS2, the system library SYS1.LPALIB requires expansion space. 
Refer to OS/VS1 Storage Estimates, GC24-5094, and OS/VS2 Storage 
Estimates, GC28-0604, for more information. 



SMF will reduce system throughput by various amounts depending on such factors 
as: 

t SMF options selected, especially buffer size, SMF data set size, and SMF data set 
device. 

• Execution times of user written exit routines. 

• System configuration, especially the type and degree of multiprogramming. 

• Job stream characteristics, such as the number of jobs, the type of jobs, and any 
user data set requirements. For example, a job stream consisting of short-running 
job steps causes more system overhead than a job stream consisting of 
longer-running job steps. 
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Category of 
Data 






Use Factor Definition 


Record 
Type 

No. 


Record Size (in Bytes) 


Event or Status 


MAN= 


OPT= 


DSV= 


Day Data 


IPL 


ALL 









31 


Partition Definition 


ALL 






13 


16 + 22 per partition 


Devices Online at IPL 


ALL 






8 


16 

+ 4 per device 


End of day 


ALL 






12 


34(VS1);54(VS2) 


Machine Data 


Accumulated Wait Time 


ALL 






1 


34(VS1);54(VS2) 


SMF Records Lost 


ALL 






7 


24 


Devices Varied Online 


ALL 






9 


16 

+ 4 per device 


Device Varied Offline 


ALL 






11 


20 


Device Recovered by Allocation 


ALL 






10 


44 


Auxiliary 
Storage Data 


Space Available on DASD 
Volumes at IPL, HALT EOD, 
and when Demounted 


ALL 




1,3 


19 


64 


Processing 
Data 


Job Processing 


ALL 


1,2 




5 


117 

+ 1 per accounting data item 

+ 1 per accounting data character 


Job Purge (in VS2 with HASP) 


ALL 






26 


196 


Step Processing 


ALL 


2 




4 


117 

+ 8 per DD statement 

+ 1 per accounting data item 

+ 1 per accounting data character 


SYSOUT Processing 


ALL 






6 


64(VS1) 

57 (VS2 without HASP) 

90 (VS2 with HASP) 


Data Set 
Activity Data 


Initiation of a Job with Data Set 
Activity Recording 


ALL 




2,3 


20 


61 

+ 1 per accounting data item 

+ 1 per accounting data character 


Closing, or 
EOV 

Processing of a 
Data Set 


Data Set 
Opened for 
INPUT, or 
RDBACK . 


ALL 




2,3 


14 


264 

+ 24 per UCB 

+ 28 for ISAM 


Data Set 
Opened for 
OUTPUT, 
UPDATE, 
INOUT, 
OUTIN . 


ALL 




2,3 


15 


264 

+ 24 per UCB 

+ 28 for ISAM 


Scratching of a Data Set 


ALL 




2,3 


17 


88 

+ 8 per data set scratched 


Renaming of a Data Set 


ALL 




2,3 


18 


132 

+ 8 per data set renamed 


VS Data 
Management 


Record Descriptor Word 


ALL 






all 


4 


Block Descriptor Word 


ALL 








4 



Figure 22. SMF Record Sizes 
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Event or Statnr 



IPL 



Partition Definition 



Devices Online at IPL 



End of day 



Accumulated Wait Time 



Device Varied Online 



Device Varied Offline 



Device Recovered at 
Allocation 



Scratch a Non-temporary 
Data Set 



Rename a Data Set 



Job Processing 



Step Processing 



SYSOUT Processing 



Record Descriptor Word 



Block Descriptor Word 



Record 



Type 



13 



19 



12 



19 



11 



10 



17 



20 



19 



14 



15 



Assumption for Th is Example 



Once per day 



Once per day (4 partitions) 



20 devices, including 6 DASD 



Once per day 



6 DASD 



Once every 10 min. for 4 hours 



Twice per hour for 4 hours 



Twice per hour for 4 hours 



Once per hour for 4 hours 



Once per 4 hours, 1 volume per 
data set 



Once per 4 hours, 1 volume per 
data set 



Example 
No. of 



bytes per 
Record 



31 



104 



96 



64 



34 



64 



34 



20 



20 



44 



96 



140 



Total for these records 



Accounting Data 1 



Demount 2 DASD volumes 



4 DD statements per step 2 , 
Accounting Data 1 , 3 steps per 
job 



1 EOV processing and close 2 
data sets per step, 3 steps per job 



1 EOV processing and close 2 
data sets per step, 3 steps per job 



2 output writers per step, 3 steps 
per job 



129 



73 



64 



161 



288 



288 



64 



Total for one job 



Total for 12 jobs per 
hour for 4 hours 



48 Jobs 



Example 

No. nf 



Records 



1 
1 
1 
6 
1 
6 
24 



62 



31 



1488 



Total SMF Data 



6 Records per block 



Example Total 



Job Related 
Records 



1550 



259 



Total number of bytes for this example 



1 In this example, accounting data consists of two 5-byte items. 

2 None of the four DD statements refers to DD data, DD *, or SYSOUT data sets. 

Figure 23. Example of Data Set Space Requirements 



129 

73 
128 
483 

2,592 

2,592 

384 



6,381 



System 



Related 
Records 



31 
104 
96 
384 
34 
384 
816 
160 
160 
176 

96 

140 



2,601 



306,288 



308,889 
6,200 
1,036 



316,125 
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Operational Considerations 



IPL Procedures 



The system operator is responsible for operational procedures, such as the 
requirements for IPL and for dumping the SMF data set, and for any special 
procedures required by user written report and analysis routines. 



SMF initialization is the final step of the system IPL procedure. The SMF initialization 
program checks for the existence and validity of the SMFDEFLT member and for the 
availability of the devices on which data sets SYS1.MANX and SYS1.MANY are 
defined. 

If SMFDEFLT has not been entered into SYS1.PARMLIB, the initialization program 
writes a message to the console, allowing you to enter SMFDEFLT parameters from 
the console. If the verification program encounters an input/output error while 
reading SMFDEFLT, it writes a message to the console, allowing you to either repeat 
the IPL procedure or enter SMFDEFLT parameters from the console. 

If the initialization program finds SMFDEFLT and reads it without error, each 
parameter is checked for accuracy. If any parameters are incorrectly specified or if 
required parameters are omitted, messages are issued, allowing the operator to enter 
the correct parameter from the console. If all parameters are correctly specified and 
operator intervention is allowed (OPI=YES was specified in SMFDEFLT), messages 
are issued, allowing the operator to examine and modify the parameters. 

When the initialization program has completed validation of SMFDEFLT and if SMF 
recording is requested, it checks for the existence of data sets SYS 1. MANX and 
SYS1.MANY and for the availability of the devices on which they are defined. The 
initialization routine checks for the availability of the specified device and the 
allocation of the data set on the specified direct access device. 

If an error is found, a message is issued, which indicates that no recording of SMF 
records is allowed until the condition is corrected and the IPL procedure is repeated. 

If no errors are found, the initialization routine determines which data set 
(SYSl.MANX or SYSl.MANY) should receive SMF records. If neither data set contains 
data, SYSl.MANX receives the SMF records. 

If one data set contains data and the other one is empty, the partially full data set 
receives the SMF records. If both data sets already contain data, the data set with 
the lesser amount of data receives the SMF records. 

SMF data is maintained in chronological sequence if both SYSl.MANX and 
SYSl.MANY are defined on the same type of device with the same space allocation 
and if the data sets are dumped when called for by the control program. 

When data set verification has been completed without error, the initialization 
routine writes the IPL and input/output configuration records (SMF record types 
and 8) to the SMF data set, and gives control to the system so that processing of 
input streams may begin. . 

Data Management Procedures 

Space for the SMF data set must be allocated on direct access devices before IPL. If 
possible, a device and channel other than those specified for SYSRES should be used. 
Figure 24 illustrates sample DD statements for allocating space to the SMF data set. 

Note: Specification of a secondary space allocation is ignored. 
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SMF Dump Program 



//DUMPX 


JOB 


//STEP1 


EXEC 


//DUMPIN 


DD 


//DUMPOUT 


DD 


//SYSPRINT 


DD 



//MANX DD DSNAME=SYS1 .MANX, UNIT= 190, VOLUME=SER=1 1 1 1 1 1 , 
// SPACE=(TRK,(20) ) , DISP=( NEW, CATLG ) 

//MANY — BB n9MAMF-c;vqi MANV J .nNTT=1Q1 . VOLUME=SER=222222 , 

// SPACE=(TRK,( 20 ) ) ,DISP=( NEW, CATLG ) 

Figure 24. DD Statements for Allocating Space for SMF Data Sets 
on Direct Access Devices 



The SMF dump program must be used to transfer full SMF data sets to another data 
set (on tape) for analysis. Figure 25 shows the JCL required to execute the SMF 
dump program, which is used to transfer data in its original format to tape. The SMF 
dump program uses the Basic Sequential Access Method to perform a physical copy 
from the input data set, DUMPIN, to the output data set, DUMPOUT. In the copy 
process, the program writes two SMF records to the output data set: a Dump Header 
record (record type 2) at the beginning to the data set and a Dump Trailer record 
(record type 3) at the end of the data set. The SMF dump program also writes 
messages, as required, to SYSOUT. 

201,, MSGLEVEL= 1 , PRTY= 1 2 

PGM=IFASMFDP 

DSNAME=SYS1 .MANX,DISP=OLD' 

UNIT=TAPE , DISP=( NEW , KEEP ) 

SYSOUT=A 

1 If the alternate SMF data set, sysi.MANY, is being dumped to tape, SYS1.MANY appears in the 
dsname parameter. 

Figure 25. JCL for Executing the SMF Dump Program 

When either the SYS1.MANX or SYSI.MANY is filled, a message is written to the 
console requesting a dump. In no case should a data set that is being filled be 
dumped. If the invoked SMF dump program attempts to dump the active SMF data 
set, a message is printed at the console notifying the operator of his error; in 
response, the operator must cancel the dump program. He may then invoke the 
dump program to dump the correct SMF data set. 

The SWITCH command or HALT command can be used to switch between the SMF 
data sets so the previously active data set can be dumped. The format of the 
SWITCH command is: 

The format of the HALT command is: 

When either the SWITCH or HALT command is entered, the following actions occur: 

1. A record type 19 is written for each online direct access device if DSV=1 or 
DSV=3 was specified. 

2. A record type 12 is written. 

3. The SMF buffer is written to the SMF data set. 

4. The SMF data sets are switched or interchanged (that is, a different data set is 
designated to receive SMF records). The previously inactive data set is designated 
to receive SMF records and the previously active data set is unavailable for 
recording. 
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Both the SWITCH and HALT commands cause the CPU wait time and system 
statistics accumulated up to the time of the command to be recorded in record type 
12. Thus, record type 12 contains the wait time and system statistics accumulated 
from the expiration of the ten-minute time interval reflected in the last record type 1 
to the time of the SWITCH command or HALT command. The next record type 1 
contains the wait time and system statistics accumulated from the SWITCH command 
or HALT command to the expiration of the next ten-minute time interval. 

The HALT command also causes other system actions, which are described in 
Operator's Library: OS/VS1 Reference, GC38-0110, and Operator's Library: 
OS/VS2 Reference, GC38-0210. The SWITCH command causes only the actions 
described here. 

You may enter jobs specifying execution of the dump program into the system and 
hold them on the job queue until a dump is required. You may then release the 
appropriate job to dump the specified data set. Another method for executing the 
dump is to start a reader to an input stream containing the JCL for the dump 
program. A high priority should be assigned to the dump job to ensure immediate 
initiation. 
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Report Programs 



Producing a report usually requires at least two operations: sorting the SMF records 
and writing them in an appropriate format. Your installation's requirements will 
determine what further analysis of SMF data is necessary. 



Sorting SMF Records 



You may use the operating system sort/merge program product, number 5734-SM1, 
to sort SMF records. Note, however, that sort/merge will not process user records 
that are less than 18 bytes long. Your report format and analysis requirements will 
determine the fields on which to sort and will determine the sorting sequence. Sort 
exit El 5 allows you to extract or delete selected records as the SMF dump data set is 
sorted, and sort exit E35 allows you to insert records into the final sorted output data 
set. 

Sample Sort/Merge Exit Routines 

Two sample sort/merge exit routines are provided in SYS1.ASAMPLIB: an E15 exit 
routine (called SMFE15) and an E35 exit routine (called SMFE35). The SMFE15 
routine is designed for use with SMFE35. 

The SMFE15 routine extracts all non-job oriented SMF records (that is, records 
without a job log number) from the SMF dump data set. Dump header and dump 
trailer records (SMF record types 2 and 3) are retained in a temporary data set (DD 
name hdrdata), and all other system-oriented records are retained on another 
temporary data set (DD name SORDATA). Only job-oriented records (that is, 
records having a job log number) are sorted. 

The SMFE35 routine places in the sort output data set all records extracted by the 
SMFE15 exit routine. The system-oriented records precede the sorted job-oriented 
records in the output data set and are inserted in the following order: dump header 
records, dump trailer records, and all other system records. 

An example of the JCL required to execute the sort/merge program is provided in 
the SYSl.ASAMPLiB member named SMFSORT. Figure 26 shows JCL that can be used 
to obtain a listing of sample sort exit routines and of sample sort JCL from 

SYSl.ASAMPLiB. 

If you plan to include the sample exit routines in your sort application, you must 
assemble and link-edit them before executing the sort/merge program. Figure 27 
shows JCL that can be used for this procedure, including one possible sort 
application. In this example, SMF records are to be sorted first on the job log 
number (major control field), then on the date and time portions of the time stamp 
(minor control fields). Displacements of these fields (from the beginning of the 
record) are 19, 11, and 7 bytes, respectively. 

For a description of the cataloged procedure ASMFCL (assemble and link-edit) refer 
to OS/VS Assembler Programmer's Guide, GC3 3-4021. For a detailed discussion 
of the sort/merge program you may refer to Sort /Merge, SM/1, Programmer's 
Guide, SC33-4007. 
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Designing a Report Program 

The basic operations of a report program are formatting and printing data from SMF 
records. The input to a report program is normally the sorted SMF data set. Your 
installation's report requirements will determine the amount of data modification, 
analysis, and formatting your report program must perform. 

A sample source report program (SMFFRMT), written in PL/I (product number 
5734-PLl), is provided in SYS1.ASAMPLIB. Figure 28 illustrates sample output from 
the SMFFRMT program. This program can also be used to print selected types of SMF 
records. To do so, specify the record types, separated by commas, in the PARM field 
of the exec statement. If you want to print all record types, the PARM parameter is 
not required. 

Before using SMFFRMT, you must compile the program using the PL/I compiler. 
Figure 29 shows JCL required to use SMFFRMT after it has been compiled and 
linkedited into sysi.linklib. 



//PRINT JOB 


123456, SMITH 


// EXEC 


: PGM=IEBPTPCH 


//SYSPRINT DE 


) SYSOUT=A 


//SYSUT1 DE 


) DSNAME=SYS1 . ASAMPLIB,DISP=( OLD , KEEP ) , 


// 


UNIT=XXXX , VOLUME=SER=XXXXXX' 


//SYSUT2 DE 


) SYSOUT=A 


//SYSIN DE 


) * 


PRINT 


TYPORG=PO , MAXNAME=4 , MAXFLDS=4 


MEMBER 


NAME=SMFSORT 


RECORD 


FIELD=(80) 


MEMBER 


NAME=SMFE 1 5 


RECORD 


FIELD=( 80 ) 


MEMBER 


NAME=SMFE35 


RECORD 


FIELD=( 80) 



/* 

1 The volume and unit parameters depend on your installation's request; check with your system 
programmer. 

Figure 26. JCL for Obtaining a Listing of Sample Sort Exit Routines 



50 OS/VS System Management Facilities (SMF) 



//SMFSORT JOB MSGLEVEL=1> 
//STEP1 EXEC ASMFCL 1 
//ASM.SYGIN DD * 



E15 SOURCE DECK 

/* 

//LKED . SYSLMOD DD DSNAME=SMF1 . EXITS , UNIT=231 4 , 2 
// DISP=(NEW,KEEP),SPACE=(TRK, (10,5,1)), 
// VOLUME= S ER= 231400 
//LKED.SYSIN DD * 
NAME E15(R)3 

/* 

//STEP2 EXEC ASMFCL' 

//ASM.SYSIN DD * 

E35 SOURCE DECK 

/* 

//LKED. SYSLMOD DD DSNAME=SMF1 . EXITS , DISP=( OLD, KEEP ), 2 
// UNIT=2314,VOL=SER=231400 
//LKED.SYSIN DD * 
NAME E35(R) 3 

/* 

//SORTSTEP EXEC PGM=SORT, REGION=1 00K* 
//SYSOUT DD"SYSOUT=A 

//SORTLIB DD DSNAME=SYS1 . SORTLIB, DISP=SHR 
//EXITLIB DD DSNAME=SMF1 .EXITS, DISP=( OLD, KEEP), s 
// UNIT=2314,VOL=SER=231400 

//SORTIN DD UNIT=2400,VOLUME=SER=SYSMAN,DISP=OLD, f ' 
// LABEL=( ,NL),DCB=(RECFM=VBS,LRECL=600,BLKSIZE=200 )' 
//SORTWK01 DD UNIT=23 1 4 , SPACE=( TRK, ( 50 ) , , CONTIG )« 
//SORTWK02 DD UNIT=23 1 4 , SPACE=( TRK, ( 50 ) , , CONTIG )« 
//SORTWK03 DD UNIT=23 1 4 , SPACE=( TRK, ( 50 ) , , CONTIG )« 
//SORTOUT DD UNIT=2400 , DSNAME=SMF1 . SORTOUT, LABEL=( ,NL ) , 9 
// DISP=( ,KEEP),DCB=(RECFM=VBS,LRECL=600,BLKSIZE=200 ) 7 
//SORDATA DD UNIT=SYSDA, SPACE=( CYL, ( 1 , 1 ) ) , "> 
// DCB=( RECFM=VBS , LRECL=600 , BLKSIZE=200 ) 7 

//HDRDATA DD UNIT=SYSDA, SPACE=( TRK, ( 5 , 5 ) ) , '<' 
// DCB=( RECFM=VBS , LRECL=600 , BLKSIZE=200 ) 7 

//SYSIN DD * 
SORT FIELDS=( 19, 16, A, 1 1 , 4 , A, 7 , 4 , A ) , FORMAT=BI , SIZE=E4000" 
MODS E 15=(E 15, 700, EXITLIB, N),E35=(E35, 1 500 , EXITLIB, N )" 
END 
/* 

1 exec statement for cataloged procedure ASMFCL (assemble and link-edit). 

2 The sample sort exit routines will be link-edited into data set smfi. exits. 

3 Linkage editor control statements specifying that E15 and E35 will be the load module names of 
the exit routines. 

4 EXEC statement for the sort/merge program. 

5 Data set SMFI. EXITS is specified as the library in which sort exit routines may be found. 

6 Input to the sort program is the SMF dump data set, contained on a tape having a volume serial 
number of SYSMAN. 

7 The LRECL value may be larger than the bli^SIZE value because records may be spanned. The 
LRECL value must be as large as the longest SMF record being created plus four bytes for the 
RDW. You are expected to modify these parameters according to your buffer size and the 
longest record collected. 

8 Three sort work units are defined as being direct access devices. 

9 The sort output data set is to be written on tape. 

10 Two data sets required by the sample sort exit routines are defined on direct access devices. 

11 The sort/merge control statements define the sort control fields and exit routines to be used in 
this sort application. 

Figure 27. Sample Sort Procedure 
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HEADER/RECORD 
02 0102 00681590 0072017F C2C2 F4F5 



RECORD 
TYPE 



08 0108 0066D2E5 0072017F C2C2 F4F5 

002E 082300090802000D0808000E0808000F200802302008023 1200802 
3220080233200802342008023520080236 

01 0101 0066D2E8 0072017F C2C2 F4F5 

0000602C 0066D2E8 00000000 00000000 00000000 

13 010D 0066D32F 0072017F C2C2 F4F5 

002E 000040000001404040404040404040404040404040C1 01020000 
000340404040404040404040404040C1D1D4 

10 010A 00672333 0072017F C2C2 F4F5 

4040404040404040 00000000 00000000 4040404040404040 0006 
0801000C 

05 0105 00677297 0072017F C2C2 F4F5 
C1C1D1E2F5F6C1F0 00672FFE 0072017F 0000000000000000 01 
006769F5 0072017F 00000000 0000 06 00673036 0072017F 
00 8000000000 00 0801 C1 00 00000000000000000000000000 
000000000000 2E D7C5D5C3C540D1E6404040404040404040404040 
000173 01 15 F7F6F0F1F0F1F3F1F6F2F0F2F7D5F0F2F2D7D9D6C4 

06 0106 006774D1 007201 7F C2C2 F4F5 
C1C1D1F2F5F6C1F0 00672FFE 0072017F 0000000000000000 CI 
00677408 0072017F 00000008 00 01 40404040 

05 0105 0067AE1F 0072017F C2C2 F4F5 
C1C1D1E2F5F6C2F0 00677F2F 0072017F 0000000000000000 01 
00678298 0072017F 00000000 0000 06 00677F68 0072017F 
00 8000000000 00 0801 CI 00 00000000000000000000000000 
000000000000 2E D7C5D5C3C540D1E6404040404040404040404040 
00031C 01 15 F7F6F0F1F0F1F3F1F6F2F0F2F7D5F0F2F2D7D9D6C4 

06 0106 0067B073 0072017F C2C2 F4F5 
C1C1D1E2F5F6C2F0 00677F2F 0072017F 0000000000000000 CI 
0067AF96 0072017F 00000008 00 01 40404040 

12 010C 0067B81A 0072017F C2C2 F4F5 

00009B2F 0067B7FF 0000051A 000005BF 00000002 

03 0103 0068161A 0072017F C2C2 F4F5 





DATE 
PAGE 


72( 


3117 
1 


* BB 45 






* 


*. . . .KV BB 45 

* 






* 
* 


* 






* 


*. . . .KY BB 45 

* KY 


* 

* 


*. . . .L BB 45 

* 

* . . AJM 


A . 




* 
. * 

* 


* BB 45 

* 






* 

* 


* 






* 


* BB 45 

*AAJS56A0 






* 
* 


* . . .5 




* 


* A . ... 






* 


* PENCE JW 

* 7601013162027N022PROD 


* 
* 


* J .... BB 45 

*AAJS56A0 




A 


* 
* 


* 




* 


* BB 45 

*AAJS56B0 






* 
* 


* 




* 


* . A . ... 






* 


* PENCE JW 

* 7601013162027N022PROD 


* 

* 


* BB 45 

*AAJS56B0 . 




A 


* 
* 


* 




* 


* BB 45 

* 






* 
* 


* BB 45 




* 



Figure 28. Sample Output from SMFFRMT Program 



//FORMAT JOB 123456, SMITH 

//FRMT EXEC PGM=SMFFRMT , PARM= '1,2,3,5,6,8,9,10,11,12,13' 

//SYSPRINT DD SYSOUT=A 

//REPORT DD SYSOUT=A,DCB=(RECFM=VBA,BLKSIZE=3500 ) 

//SMFDATA DD DISP=( OLD , KEEP ), LABEL=( , NL) , VOL=SER=XXXXXX, ' 

// UNIT=2400,DCB=(RECFM=VBS,BLKSIZE=1000 ) 2 

1 The tape volume serial number replaces the X's. 

2 The BLKSIZE is one-half the value specified as the SMF IPL parameter BUF. For this example, 
BUF is equal to 2,000. 

Figure 29. Sample JCL to Run SMFFRMT 
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Exit Routines 



This chapter contains information for planning and writing exit routines. It 
describes: 

• Exit routine facilities and restrictions, including information on communication 
among user written exit routines; parameters passed to exit routines; the 
SMFWTM macro instruction, which can be used by exit routines to write a record 
to the SMF data set; and the ifasmfr macro instruction, which can be used to 
symbolically address fields in SMF records. 

• Exit routines, including a full description of each of the sample SMF exit routines. 
Figure 30 shows the exits available in each system. 



Exit 


VS1 


VS2 


IEFUIV 


Yes 


No 


IEFUJV 


Yes 


Yes 


IEFUJI 


Yes 


Yes 


IEFUSI 


Yes 


Yes 


IEFUSO 


Yes 


No 


IEFUTL 


Yes 


Yes 


IEFU83 


No 


Yes 


IEFACTRT 


Yes 


Yes 


IEFUJP 


Yes 


Yes 1 



1 In VS2 systems, this exit is available only when HASP is in the system. 
Figure 30. Exits Available in Each System 



Exit Routine Facilities and Restrictions 



The functions performed by your exit routines are determined solely by the 
requirements of your installation. The following paragraphs describe exit routine 
restrictions, formats of parameters passed to each exit, and the required return 
codes. Sample Assembler language exit routines for some exits are provided in a 
member (SMFEXITS) of SYS1.ASAMPLIB. Figure 31 shows the JCL required to 
retrieve a listing of these sample routines. 

123456, SMITH 

PGM=IEBPTPCH 

SYSOUT=A 

DSNAME=SYS 1 . ASAMPLIB , DISP=( OLD , KEEP ) , 

UNIT=XXXX , VOLUME=SER=XXXXXX< 

SYSOUT=A 

* 

TYPORG=PO,MAXNAME=1 ,MAXFLDS=1 

NAME=SMFEXITS 

FIELD=(80 ) 

1 The volume and unit parameters depend on your installation's request; check with your system 
programmer. 

Figure 31. JCL for Obtaining a Listing of Sample Exit Routines 



//PRINT 


JOB 


// 


EXEC 


//SYSPRINT 


DD 


//SYSUT1 


DD 


// 




//SYSUT2 


DD 


//SYSIN 


DD 


PRINT 




MEMBER 


RECORD 


/* 
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User written exit routines for the exit IEFU83 must be written in re-enterable code. 
All other user written exit routines should be written in re-enterable code, because 
the link edit attributes of the load module are subject to change from release to 
I release. All user written exit routines receive control via a BALR. User written exit 
routines must save registers when they receive control and restore registers before 
returning to the control program. Register 13 contains the address of the register 
save area, register 14 contains the return address, and register 15 contains the entry 
point address. 

Under VS2, all SMF exit routines except IEFU83 can access installation-defined data 
sets. Under vsi, all exit routines except IEFUSO and IEFUTL can access 
installation-defined data sets. 

User written exit routines can communicate with each other via the 
user-commmunication field and the user-identification field. The user- 
communication field can be used to communicate between exits taken for different 
jobs. The user-identification field can be used to communicate between exits of the 
same job. These fields are passed to every exit routine except IEFU83, which is only 
available in VS2, and are logically part of each job. The user-communication field is 
initialized to binary zeros at reader initialization (starting a reader or restoring a 
transient reader). The user-identification field is initialized to blanks as each new job 
is read. 

Any exit routine may obtain an additional work area by issuing a GETMAIN macro 
instruction that specifies an appropriate subpool in system queue area. Figure 32 
shows the characteristics of the subpools that can be specified. The address of the 
work area can be placed in the user-communication field. (You must consider the 
storage required by this work area when estimating the size of system queue area.) 

Note: Communication areas obtained by exits are not maintained if the system is 
restarted. 



Subpool Number 


Storage Is Allocated 


Storage Is De-allocated 


245 


In system queue area. 


Explicitly, by issuing a FREEMAIN macro 
instruction. 


253 


In partition queue area. 


Automatically at end of task. 


254 


In partition queue area. 


Automatically at end of step. 


255 


In partition queue area. 


Explicitly, by issuing a FREEMAIN macro 
instruction. 



Note: Only routines having a protection key of can obtain the storage in system queue area (vsi 
or VS2) or high in a partition (VSl). 

Figure 32. Characteristics of Subpools in System Queue Space 
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If an exit routine cancels a job during or after job initiation, a job termination record 
(record type 5) is written to the SMF data set if the writing of records is permitted. 
If you require job cancellation information in the System Output Message Data Set, 
you may pass a message to module IEFYS from the termination exit routine 
IEFACTRT. At job termination time, you can determine if an IEFUJV (vsi only), 
IEFUJI, IEFUSI, or IEFACTRT exit routine canceled a job, by examining the job 
termination indicators in record type 5. At step termination time, you can determine 
if an IEFUSO (vsi only) or 1EFUTL exit routine canceled a job, by examining the 
step completion code field in record type 4. The system does no recording of jobs 
canceled before job initiation except in VS2 systems with HASP. In VS2 with HASP, 
all jobs read by HASP will cause record type 26 to be generated regardless of when 
the job is canceled. At job purge time, you can determine if the job did not get to 
job initiation by examining the step number in the common exit parameter area for 
zero. In VSI, the only exit before job initiation is IEFUIV; in VS2, the only exit before 
job initiation is IEFUJV. The installation may, however, write a record to the SMF 
data set from these exits when a job is not accepted for processing prior to job 
initiation. 

Your routines can use the SMFWTM macro instruction to write to the SMF data set. 
If you want to use your own data sets, you must define them for VSI, as follows: 

• A data set used by exit routine IEFUIV requires a DD statement in the reader 
cataloged procedure. 

• A data set used by exit routines IEFUJV, IEFUJI, IEFUSI, and IEFACTRT requires a 
DD statement in the initiator cataloged procedure. 

• A data set used by exit routine IEFUJP requires a DD statement in the writer 
cataloged procedure. 

You cannot write to your own data sets from the exit routines IEFUSO and IEFUTL. 

If you want to use your own data sets, you must define them for VS2, as follows: 

• A data set used by exit routine IEFUJP requires a DD statement in the HASP 
cataloged procedure. 

• A data set used by exit routines IEFUJI, IEFUSI, IEFUTL, and IEFACTRT 
requires a DD statement in the initiator cataloged procedure. 

Note: In either vsi or VS2, user data sets cannot be allocated to SYSOUT. 

Exit Routine Parameters 

When an exit routine receives control, register 1 points to a list of four-byte 
addresses. The first entry in the list is common to all exit routines except IEFU83. 
The first entry points to a parameter area that is 72 bytes long for VSI when 
SMF=FULL is specified or 36 bytes long for VS2. 

Figure 33 describes the format of the parameter area for VSI. Note that the fields in 
the parameter area are filled in chronologically; therefore, not all fields are 
meaningful for all exits. The first 36 bytes shown in Figure 33 describe the format 
of the parameter area for VS2. 

Figure 34 summarizes the information available to each exit (in addition to common 
exit parameters, described in Figure 33) when each exit is called, and the return 
from each exit to the control program. The names in parentheses are mandatory 
entry-point names that must be assigned. 
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Displacement 
from Pointer 



12 

16 

20 

28 
29 



Field 
Size 



30 

32 



Data 

Format Description 

EBCDIC Job name 

binary Time, in hundredths of a second, that the reader 
recognized the JOB card for this job 

packed Date that the reader recognized the JOB card for the 
decimal job, in the form ooyydddf, where F is the sign 

EBCDIC System identifier and model identifier (two bytes each) 

EBCDIC User identification field. SMF places this data in all 

subsequent records for this job. This field is initialized 
to EBCDIC blanks for each job. 1 

binary Number of the step being processed 

binary Eight indicators of SMF options that are selected by the 
user. A bit setting of 1 indicates the related option was 
selected. 

Bit Option 

Job accounting 

1 Step accounting 

2 Dynamic exits 

3 Data set accounting 

4 Volume accounting 

5 Reserved 

6 Temporary data set scratch records 

7 — Background job 
1 — Foreground job 2 

binary Reserved 

binary User communication field. This field is intended to be a 
user exit routine communication field. The reader 
initializes this field to zeros only when the reader is 
started or a transient reader is restored. 1 



The following fields apply to only VSI: 

Real time in reader, in hundredths of a second 

Number of lines read 

Job priority 

Reserved 

Job class 

Reserved 

Real time to print, in hundredths of a second 

Number of SYSOUT lines printed 

Real time to punch, in hundredths of a second 

Number of SYSOUT lines punched 

Real time for tape, in hundredths of a second 

Number of SYSOUT lines written to tape 

1 These two fields are the only fields provided for user modification. 

2 Because TSO does not operate under VSI, bit 7 is always when VSI is used. 

Figure 33. Common Exit Parameter Area 
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binary 


52 
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binary 
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Exit Routine 



Input Stream 
Validation — 
VSl only 
(iefuiv) 



Job Validation 

(IEFUJV) 



Job Initiation 
(iefuji) 



Step Initiation 
(iEFUSl) 



SYSOUT Limit- 
VS1 only 
(iEFUSO) 



Time Limit 
(iefutl) 



smf Record- 
VS2 only 
(IEFU83) 



Termination 
(iefactrt) 



Job Purge- 
VS1 only 
(IEFUJP) 



Job Purge- 
VS2 with 
HASP 
(IEFUJP) 



Parameters Passed 



JCL i mage of JOB 
statement. 



JCL image, JCL type. 



Programmer name, 
priority, account field. 



Step program name, step 
name, accounting fields. 



DCB. 



Entry type. 



SMF record to be written. 



Programmer name, job 
CPU time (in hundredths 
of a second), job 
accounting fields, step 
CPU time (in hundredths 
of a second), step 
accounting fields, 
completion code, SMF 
record. 



Programmer name, job 
CPU time, number of 
accounting fields in the 
JOB statement, address of 
the accounting 
information. 



SMF record to be written. 



When Entered 



Wh e n a JOB card i s- 



encountered by 
input-stream control. 



Each JCL card (excluding 
comment statements), 
after all JCL has been 
interpreted. 



Job initiation. 



Step initiation. 



SYSOUT limit exceeded. 



Job CPU time limit 
exceeded, step CPU time 
limit exceeded, continuous 
wait time limit for the job 
exceeded. 



When a record is to be 
written to the SMF. 



Step termination, job 
termination. 



When a job is ready to be 
purged from the system. 



When a job is ready to be 
purged from the system. 



Type of Return 



Continue or cancel . 



Continue or cancel. 



Continue or cancel. 



Continue or cancel. 



Continue with new 
limit or cancel. 



Continue with new 
time limit or cancel. 



Write or don't write 
SMF record to SMF. 



Continue or cancel; 
write or skip SMF 
record. 



None. 



Write or skip SMF 
record. 



Figure 34. Exit Routine Characteristics 



SMFWTM Macro Instruction 



You may use the SMFWTM macro instruction in any routine except IEFU83 that has a 
protection key of to write a record to the SMF data set. The macro is supplied on 
SYS1.MACLIB. 

Note: Record types 128 through 255 are available for user written records. 

The format of the SMFWTM macro instruction is: 

[ label] SMFWTM { record address \(r)} 

where: 

record address 

is the symbolic address of the record to be written. 



(r) 



is a register containing the address of the record. You may use either the absolute 
register number or a symbolic designation. In either case you must enclose the 
value in parentheses; for example, (2) or (REG2). 
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The record to be written should include a standard SMF record header and a record 
descriptor word (RDW). See the first fourteen bytes of record type 6 in the chapter 
"Accounting Records" for the header format. For a discussion of the RDW, refer to 
OS/VS Data Management Services Guide, GC26-3783. 

Note: The sort/merge program product will not process records less than 18 bytes 
long. 

The SMFWTM macro instruction returns a code in register 15, which indicates the 
disposition of the user record as follows: 

• 0, which indicates that the record was written without error. 

• 4, which indicates that the record was truncated, because it would not completely 
| fit in an empty SMF data set. 

• 8, which indicates that the record was not written, because the specified length 
was less than five bytes. 

• 12, which indicates that the record was not written, because the routine was not 
authorized to write to the SMF data set. (The requesting routine had a non-zero 
protection key.) 

• 16, which indicates that the record was not written, because (a) the writing of 
records to the SMF data set is prohibited (that is, MAN=NONE was specified in 
SMFDEFLT), or (b) the writing of records is allowed but the SMF data set was 
full. If the SMF data set is full, it must be dumped before additional SMF records 
can be written. (See "Operational Considerations" in the chapter "System 
Information and Requirements" for the procedure for executing the SMF dump 
program.) 

• 20, which indicates that the record was not written, because the IEFU83 exit 
specified that the record should not be written (VS2 only). 



IFASMFR Macro Instruction 



You may use the IFASMFR macro instruction in exit routines (or in any problem 
program application) to symbolically address SMF record fields. The macro is 
| supplied on SYS1.AMODGEN. 

The format of the IFASMFR macro instruction is: 

[ label] IFASMFR [ n ][,SUBSET1][,SUBSET2] 

where: 

n 

is the record type to be defined. If more than one record type is specified, the 
record types must be enclosed in parentheses and separated by commas. The 
| values of n can be 0-15, 17-21, 30-35, 40-42, 43-45, and 47-49. 

SUBSET1 

specifies that record types 0-13 are to be defined. 

SUBSET2 

specifies that record types 14 and 17-21 are to be defined. 

Because of the similarity of record types 14 and 15, whenever record type 15 is 
specified, record type 14 is defined. Therefore, record types 14 and 15 cannot both 
be specified in one program using the IFASMFR macro instruction. If both are 
specified, a multiple definition of record type 14 is produced. 

Note: You must enter at least one of the parameters with the IFASMFR macro n 
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instruction. If required, a CSECT or DSECT statement must be supplied ahead of the 
macro instruction. 



VS1 and VS2 Exit Routines 



The exits available for user written routines in both vsi and VS2 are fully described 
in the topics that follow. 



lEFUJV-^Job Validation Exit 



The IEFUJV exit can be taken from both the background and the foreground. IEFUJV 
receives control just before each JCL 80-character image (other than comment 
statements) for a job is interpreted and after all JCL images have been interpreted. 

A user written routine entered at this exit might do any or all of the following: 

Validate any account fields included in the JOB and EXEC statements by 
comparison with a standard list. 

Validate or assign the priority. 

Validate or assign the REGION request. 

Validate or assign job time and job step time parameters. 

Control output stream data by assigning a SPACE parameter to SYSOUT 
statements. 

Check for authorization to use data sets. 

Create installation-defined accounting records. 

Assign the user-identification field to be included in SMF termination records and 
the SYSOUT records for the job. 

Depending on the processing you want to perform, it may be more efficient to check 
JOB and EXEC statement accounting fields at the exits provided for job initiation and 
the first job step initiation, respectively. The fields are passed as parameters to those 
routines, making a statement scan routine unnecessary. You may assign user 
identification at either of these exits and may write messages to the system output 
message data set from the IEFACTRT exit routine. 

Note: The user-communication field is initialized to binary zeros when the reader is 
started or a transient reader is restored. Data placed in this field by the IEFUJV exit 
routine will become part of each job when it is enqueued and will be accessible by 
exit routines (except IEFU83) entered in processing each job. Data placed in the field 
by the IEFUJV exit routine will be the same the next time this exit routine is entered 
unless a new reader is started or a transient reader is restored. 

At entry to the routine, register 1 points to a list of four-byte addresses, as follows: 

1. The address of an exit parameter area. (See Figure 33.) 

2. The address of an 80-character JCL statement image (in EBCDIC). JCL statements 
are identical to those listed in the SYSOUT data set; control statements containing 
only comments, however, are not made available. If a cataloged procedure is 
being executed, it is expanded before this exit routine receives control; the 
sequence of statements is JOB, EXEC PROC=..., EXEC PGM=..., followed by the 
other statements of the procedure. Override statements immediately precede the 
statement being overridden. 
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Sample IEFUJV Routine 



3. The address of a one-byte area that indicates the type of JCL statement being 
presented to the exit routine. The indicator will have one of the following binary 
values: 

0, which indicates a null statement. 

1, which indicates a JOB statement. 

2, which indicates an EXEC statement. 
4, which indicates a DD statement. 

8, which indicates a PROC statement (for symbolic parameter definition). 

16, which indicates that no statement is being presented and that all JCL images 
have been passed to the exit. 

The job validation routine may test and modify any of the operand fields in the job 
control statements and indicate, through a return code passed to job management, 
whether processing of this job is to continue. If the user modifies a job control 
statement, the modified statement is passed to the interpreter for processing. The 
modified statement appears in the SYSOUT listing. 

Editing of the job control statements must not result in additional job control 
statements or continuation cards. Operand fields being added must not precede the 
first operand of any JCL statement image. 

Before the IEFUJV exit routine returns to the control program, it must place a return 
code in register 15. A value of indicates that processing of the job should 
continue; a binary value of 4 indicates that the job is to be canceled. A job canceled 
at this exit in VS1 causes the job initiation records not to be written. A job canceled 
at this exit in VS2 causes all SMF records not to be written. 

Note: In VS2, the SMF data set will not contain any record of jobs not accepted by 
this exit unless the user written exit routine writes it. 



The sample IEFUJV exit routine provided in the member SMFEXITS of 
SYS1.ASAMPLIB checks the validity of a continued JOB statement and of values 
supplied for REGION, PRTY, TIME, and accounting parameters in JOB statements. 
Characters from the account number are used to index a table that contains 
allowable values for these parameters. If any value is found to be invalid, the job is 
terminated. 



IEFUJI — Job Initiation Exit 



The IEFUJI exit can be taken from both the background and the foreground. IEFUJI 
receives control just before each job is initiated. 

The job initiation exit may be used to change job priority and to validate job 
accounting information. 

At entry to the routine, register 1 points to a list of four-byte addresses, as follows: 

1. The address of an exit parameter area. (See Figure 33.) 

2. The address of a 20-byte area containing the programmer's name (in EBCDIC) 
from the JOB statement. This area is aligned left and, if necessary, padded with 
blanks. 
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3. The address of a one-byte area indicating the requested job priority. 



4. The a ddiess of an aiea containing accounting information from the JOB 

statement. If the JOB statement contains no accounting information, the area is 
one byte of zeros. 

The accounting fields are placed in a formatted list for easy access. Figure 35 shows 
the format of the accounting information that is available to IEFUJI. 

Decimal Hexadecimal Field Data 

Displacement Displacement Size Format Contents 

I 1 binary Number of accounting fields in 

statement (0 for no fields) 

1 1 Consecutive accounting fields 1 

1 Each entry for an accounting field contains the length of the field (one byte, binary), followed by 
the field (variable length, EBCDIC). The entry for a null accounting field contains a length of 
zero. (Null accounting fields are indicated by consecutive commas in the accounting field of a 
JOB statement.) 

Figure 35. Format of Accounting Information 

If the installation uses major and minor account numbers with several fields, this exit 
is easier to use for account number processing than IEFUJV is because of the 
formatted list. 

Before the IEFUJI exit routine returns to the control program, it must place a return 
code in register 15. A value of indicates that processing of the job is to continue; a 
binary value of 4 indicates that the job is to be canceled. A job canceled at this exit 
causes the job initiation record not to be written. 

Sample IEFUJI — Routine 

The sample IEFUJI exit routine provided in the member SMFEX1TS of 
SYS1.ASAMPLIB determines how long a job has been in the input job queue before it 
is initiated. This value and the job priority are written to the SMF data set. 

IEFUSI— Step Initiation Exit 

The IEFUSI exit can be taken from both the background and the foreground. IEFUSI 
receives control just before each job step is initiated, prior to allocation. (If OPT= 1 
was specified in the SMFDEFLT data set, this exit is not taken.) 

The step initiation exit may be used to validate job step accounting information and 
to write to an installation data set. 

At entry to the routine, register 1 points to a list of four-byte addresses, as follows: 

1. The address of an exit parameter area. (See Figure 33.) 

2. The address of an eight-byte area containing the job step name (in EBCDIC) from 
the EXEC statement. This area is aligned left and, if necessary, padded with 
blanks. 

3. The address of an eight-byte area containing the program name (in EBCDIC) from 
the JOB statement. This area is aligned left and, if necessary, padded with blanks. 

4. The address of an area containing step accounting information from the EXEC 
statement. This area has the format shown in Figure 35. 

Before the IEFUSI exit routine returns to the control program, it must place a return 
code in register 15. A value of indicates that processing of the job should 
continue; a binary value of 4 indicates that the job is to be canceled. 

No sample IEFUSI exit routine is provided in SYSI.ASAMPLIB. 
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IEFUTL Time Limit Exit 



The iefutl exit can be taken from the background only. IEFUTL receives control 
when one of the following time limits expires: 

• The job CPU time limit (from the JOB statement). 

• The step CPU time limit (from the EXEC statement or reader procedure). 

• The continuous wait time limit for the job (from SMFDEFLT). 

If a job time limit is specified on the JOB statement, the limit for each step will be 
set to job step time limit (selected from the TIME value coded on the EXEC 
statement or time limit in the reader procedure) or the remaining job time, 
whichever is smaller. 

If no time limit is specified on the JOB statement, each job step is timed individually 
by using the TIME value from the EXEC statement or the time limit value from the 
reader procedure. 

Specifying TIME=1440 on the JOB statement eliminates all timing for the job. 
Specifying TIME=1440 on the EXEC statement without a JOB time limit specification 
eliminates job step timing for the step. 

The time limit exit can be used to control and record time expirations. For example, 
you may use this exit to inform the operator that a job has exceeded the continuous 
wait time limit and request a reply to cancel the job or extend the time limit. 

The asynchronous exit interface routine sets a step must-complete status before SMF 
installation exit IEFUTL is given control. Consequently, the system will become 
interlocked in VS2 or the initiator will abnormally terminate in VS1 if the exit 
enqueues on a resource already enqueued on by the job step task or any of its 
subtasks. This enqueue can come from within SVCs, for example, the SMFWTM and 
WTO macros. 

At entry to the routine, register 1 points to the address of an exit parameter area. 
(See Figure 33.) Register will have one of the following binary values: 

• 0, which indicates that the job CPU time limit expired. 

• 4, which indicates that the job step CPU time limit expired. 

• 8, which indicates that the continuous wait time limit for the job expired. 

Before the IEFUTL exit routine returns to the control program it must place a return 
code in register 15. A value of indicates that the job is to be canceled; a binary 
value of 4 indicates that the job is to continue processing with an additional time 
allocation. The additional time (in timer units) must be placed in register 1 . The 
number of timer units is determined by the following algorithm: 

1 second =3 8400 timer units 

The exit routine should control the number of extensions for a given job to prevent 
looping. It may record the expiration in the SMF data set or as a message to the 
console. It may not record the expiration in an installation-defined data set. 

Note: Time can be extended only within a step. When the step is completed, the 
next step will never be started if the total job CPU time used is greater than the job 
CPU time limit including the extension. Also, be sure to return control in the 
supervisor state with a protect key of 0. 
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Sample IEFUTL Routine 

The samp le ihHJ l L exit louline piuvided in the membe r SMFEXITS of 



SYS1.ASAMPLIB causes a job to be terminated if the job CPU time limit or job step 
CPU time limit has been exceeded. If the continuous wait time limit for the job has 
been exceeded, the limit is extended twice; on the third entry for exceeding the 
continuous wait time limit for the job, the job is canceled. Each time the routine is 
entered for an exceeded job wait time limit, it writes a record to the SMF data set 
describing the action taken. 



IEFACTRT — Termination Exit 



The IEFACTRT exit can be taken from both the background and the foreground. 
| IEFACTRT receives control when execution of a job or job step is terminated.' (If 
OPT=l was specified in the SMFDEFLT data set, this exit is taken only at job 
termination.) 

The termination exit may be used to perform your own unique accounting functions. 

At entry to the routine, register 1 points to a list of four-byte addresses, as follows: 

1 . The address of an exit parameter area. At entry for job termination the 
parameter at displacement 28 contains the number of steps in the job. (When 
SMF=BASIC is specified, this field contains the address of the jobname.) 

2. The address of an eight-byte area containing the job step name (in EBCDIC). 
This area is aligned left and, if necessary, padded with blanks. At job 
termination the address is zero. 

3. The address of a 20-byte area containing the programmer's name (in EBCDIC). 
This area is aligned left and, if necessary, padded with blanks. 

4. The address of a four-byte area that contains, in the first three bytes, 
accumulative job CPU time in hundredths of a second (a binary value). The last 
byte contains the number (binary) of accounting fields in the JOB statement. 

5. The address of an area that contains accounting information from the JOB 
statement. This area has the format described earlier in Figure 35, excluding the 
first field shown (the number of accounting fields). If the JOB statement 
contains no accounting information, the area contains one byte of zeros. 

6. The address of a four-byte area that contains, in the first three bytes, step CPU 
time in hundredths of a second (a binary value). The last byte contains the 
number (binary) of accounting fields in the EXEC statement. At job termination 
the address is zero. 

7. The address of an area that contains accounting information from the EXEC 
statement. This area has the format described earlier in Figure 35, excluding the 
first field shown (the number of accounting fields). If the EXEC statement 
contains no accounting information, the area contains one byte of zeros. At job 
termination the address is zero. 

8. The address of a two-byte area. The first byte is an indicator: if bit 7 is set to 1 
when the exit routine is entered, the job has been canceled; if the exit routine 
sets bit 7 to 1 , the job will be canceled. The second byte contains the number 
of the job step currently being processed. At job termination, this second byte 
contains the number of steps in the job. 



1 IEFACTRT also receives control at allocation time when SMF=BASIC is specified. 
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9. The address of a two-byte area containing the termination status (condition or 
completion code) of the job or job step. (When SMF=BASIC is specified, this 
field does not exist.) 

10. The address of an area containing a four-byte record descriptor word (RDW) 
immediately followed by the job step termination record (record type 5) to be 
written to the SMF data set. (When SMF= BASIC is specified, this field does not 
exist.) 

At entry to the routine, register contains a binary code indicating the reason for 
entry; a value of 12 indicates job step termination, and a value of 16 indicates job 
termination. 

Output from IEFACTRT may be directed to the console or to SYSOUT. Under SMF, 
installation information may be written either to the SMF data set or to an 
installation-supplied data set. 

If your IEFACTRT exit routine writes messages for system output, the contents of 
register 12 must be the same as when the routine was entered, and register 13 must 
contain the address of a 45-word work area. Figure 36 shows the technique that 
must be used when IEFACTRT writes to the System Output Message Class. 
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Sample IEFACTRT Routine 



Figure 36. Writing System Output Messages from IEFACTRT 

Before the IEFACTRT exit routine returns to the control program, it must place 
return codes in registers 1 and 15, as follows: 

• If register 1 contains a value of 4, the termination record is not to be written to 
the SMF data set; if it contains a value other than 4, the termination record is to 
be written. 

• If register 15 contains a value of 4, the remaining job steps are to be canceled; if 
it contains a value other than 4, processing is to continue. 



The sample IEFACTRT exit routine provided in the member SMFEXITS of 
SYS1.ASAMPLIB changes the SMF job termination and job step termination records 
(unless the job step is flushed) to user records and attempts to write them to the 
SMF data set. If the data set is full, a message indicating lost SMF records is written 
to the console. At job termination a record containing the job name, programmer's 
name, and account number is written to the SYSOUT device. 



IEFUJP— Job Purge Exit 



IEFUJP receives control when a job is ready to be purged from the system, that is, 
after the job has terminated and all the SYSOUT output that pertains to the job has 
been written. IEFUJP is available only when VS1 or HASP in a VS2 system is used. 
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The job purge exit can be used, for example, to write additional data statistics found 
in the common exit parameter area to the SMF data set by using the SMFWTM macro 
instruction. In VS2 with HASP, the job purge exit may be used to summarize a job's — 



activities in the system. 

In vsi, at entry to the routine, register 1 points to a list of four-byte addresses, as 
follows: 

1. The address of the 72-byte exit parameter area. (See Figure 33.) (When 
SMF=BASIC is specified, this field contains zeros.) 

2. Reserved. 

3. The address of a 20-byte area containing the programmer's name (in EBCDIC). 
This area is aligned left and, if necessary, padded with blanks. 

4. The address of a four-byte area that contains, in the first three bytes, job CPU 
time in hundredths of a second (a binary value). The last byte contains the 
number (binary) of accounting fields in the JOB statement. 

5. The address of the accounting information. 

In VS2 at entry to the routine, register 1 points to a list of four-byte addresses, as 
follows: 

1. The address of an exit parameter area. (See Figure 33.) 

2. The address of an area containing the job purge record (record type 26) to be 
written to the SMF data set. 

In VSI, IEFUJP does not return a code to the control program. 

In VS2, before the IEFUJP exit routine returns to the control program, it must place a 
return code in register 15. A value of other than 4 indicates that the purge record is 
to be written to the SMF data set; a value of 4 indicates that the purge record is not 
to be written. 

No sample IEFUJP routine is provided in SYS1.ASAMPLIB. 



VSI -Only Exit Routines 

The exits available for user written routines in only VS I are fully described in the 
topics that follow. 

IEFUIV — Input Stream Validation Exit 

IEFUIV receives control when the input-stream control routine encounters each 
80-character logical record of a JOB statement. IEFUIV is available only when VSI is 
used. 

The input stream validation exit may verify that the JOB statement is correct and 
acceptable for processing. This routine may also modify any of the fields in the JOB 
statement. 

At entry to the routine, register 1 points to a list of four-byte addresses, as follows: 

1. The address of the 72-byte exit parameter area. (See Figure 33.) 

2. The address of an 80-character logical record of a JOB statement. 

Before the IEFUIV exit routine returns to the control program, it must place a return 
code in register 15. A value of indicates that the job is to be accepted for 
processing; a binary 4 indicates that the job is not acceptable for processing. 
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Note that the SMF data set will not contain any record of jobs not accepted by this 
exit routine unless the user written exit routine writes it. 



No sample IEFUIV routine is provided in SYSI.ASAMPLIB. 



IEFUSO— SYSOUT Limit 



The IEFUSO exit can be taken from the background only and is available only when 
VSI is used. IEFUSO receives control when the output limit is reached in an 
SMF=FULL or SMF=BASIC system. The output limit is specified by the OUTLIM 
parameter on the DD statement or defaults to the OUTLIM parameter value of the 
JES system generation macro instruction. The OUTLIM function limits output to 
spooled data sets; it does not apply to direct SYSOUT data sets. The function is 
described in OS/ VS JCL Reference, GC28-0618 and OS /VSI Job 
Management Logic, SY24-5161. 

Note: The IEFUSO exit is not controlled by the EXT parameter. 

The asynchronous exit interface routine sets a step must-complete status before SMF 
installation exit IEFUSO is given control. Consequently, the initiator will abnormally 
terminate in VSI if the exit enqueues on a resource already enqueued on by the 
job-step task or any of its subtasks. This enqueue can come from within SVCs, for 
example, the SMFWTM and WTO macros. 

The SYSOUT limit exit may monitor the amount of output written to spooled data 
sets. It cannot write to installation-defined data sets. 

At entry to IEFUSO, register 1 points to a list of four-byte addresses, as follows: 

1. The address of the 72-byte exit parameter area. (See Figure 33.) (When 
SMF=BASIC is specified, this field contains zeros.) 

2. The address of the DCB for the data set. 

Before the IEFUSO exit routine returns control to the control program, it must place 
a return code in register 15. A value of indicates that the job step is to be 
terminated; a binary value of 4 indicates that the output limit is to be increased by 
the value placed in register 1 and processing is to continue. 

Note: Unless the output limit has been increased, the exit to the user written routine 
will again be taken when the next record is written to this SYSOUT data set. Also, be 
sure to return control in the supervisor state with a protect key of 0. 

No sample IEFUSO exit routine is provided in SYSI.ASAMPLIB. 
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IEFU83— SMF Record 



The exit available for user written routines in only VS2 is fully described in the topic 
that follows. 



IEFU83 receives control when each SMF record is ready to be written to the SMF data 
set. When IEFU83 is active (that is, when EXT=YES is specified), any module 
requesting the writing of an SMF record must have 84 bytes in its area because 
SVC83 issues a getmain for 84 bytes in which to build a parameter list. IEFU83 is 
available only when VS2 is used. This exit must be written in re-enterable code 
because the routine runs under different storage protect keys. 

This exit can be used to select the records to be written or to act on the occurrence 
of a given record. An example of the latter is asking the operator the reason for an 
I PL whenever an IPL record is to be written. 
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At entry to the routine, register 1 points to a four-byte address, which points to the 
RDW of the SMF record to be written. 



Sample IEFU83 Routine 



Before IEFU83 returns control to the control program, it must place a return code in 
register 15. A value of indicates that the record is to be written to the SMF data 
set; a value of 4 indicates that the record is not to be written. 

Output from IEFU83 may be directed to the console. It cannot be directed to an 
installation-supplied data set. 



The sample IEFU83 exit routine supplied in the member SMFEXITS of 
SYSl.ASAMPLiB examines the record to be written. If the record to be written is an 
I PL record, IEFU83 writes to the operator with a reply request for the record types to 
be written. If the record is not an I PL record, the return code depends upon the 
records currently requested. 

The sample IEFU83 routine has a special macro definition for "write to operator with 
reply" so that output normally directed to the operator is suppressed and a standard 
reply is assumed for testing with TESTEXIT. This macro should be removed if you 
want the message printed at the console. The sample routine also has special macro 
definitions for "write to operator" and "wait", which generate no-op instructions. 

Testing Exit Routines 

Because the exit routines provided by your installation will become a part of the 
control program, you must test them thoroughly. A test procedure (TESTEXIT) is 
provided in SYSl.ASAMPLiB to aid in your testing. 

Special Requirements for Testing Exit Routines 

For testing purposes only, your exit routines must conform to the following 
requirements. 

• A user subpool (0-129) must be specified in GETMAIN macro instructions. (When 
testing is completed, one of the subpools shown in Figure 32 must be specified 
for the area used to communicate between exit routines.) 

• If the SMFWTM macro instruction is used in any of your routines, you must 
provide a special macro definition in the routine. The special macro definition 
writes the TESTEXIT data set defined by the DD card having the DDNAME of 
MANX. (With the normal SMFWTM macro instruction, the data is written to 
SYSI.MANX or SYS1.MANY.) You can then process the data without accessing the 
system accounting data on SYSI.MANX and SYS1.MANY. When testing is 
completed the macro definition must be removed. 
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Figure 37 shows the SMFWTM macro instruction that is required for testing. 
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Figure 37. SMFWTM Macro Definition Required for Testing 

TESTEXIT Procedure 

Included in the test procedure is an Assembler language source program (also named 
TESTEXIT). This source program attaches the data generator utility program 
(lEBDG) to create sample parameter lists; TESTEXIT then calls each exit routine 
being tested, passing the appropriate parameter list to it. Figure 38 illustrates the 
input/output and control flow of the TESTEXIT routine. 




lEFUSO(VSl) 
^ J IEFUTL " „ 



, J IEFU83 (VS2). 
^ J IEFACTRT 



IEFUJP 



Figure 38. TESTEXIT Input/Output and Control Flow 
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I Figure 39 is an example of JCL that invokes TESTEXIT in an unmodified system. 
Following is a summary of the operations performed by the procedure shown in 



Figure 39 : " 

• The TESTEXIT job assembles the TESTEXIT routine (not illustrated in the figure) 
and link-edits it with the exit routines being tested. The exit routines must reside 
in a partitioned data set (exitlib). 

• The DATAGEN job, using the IEBUPDTE utility program, creates a partitioned 
data set (dginput) containing control statements for the IEBDG utility program, 
which will be attached by the TESTEXIT program. 

• The TESTING job includes the execution of the TESTEXIT program. 

The 1 at the right side of the figure indicates exits available only when VSl is used; 
the 2 at the right side of the figure indicates exits available only when VS2 is used. 

//TESTEXIT JOB MSGLEVEL=1 
//TEST EXEC ASMFCL 

//ASM.SYSIN DD * 

(TESTEXIT Source Module) 

/* 

//LKED . SYSLMOD DD DSNAME=TESTLIB, VOLUME=SER=23 1 400 , 

// UNIT=2314,SPACE=(TRK,( 5,2,1 ) ), 

// DISP=( NEW, KEEP) 

//LKED. EXITS DD DSNAME=EXITLIB, VOLUME=SER=23 1 400 , 

// UNIT=2314,DISP=OLD 

//LKED.SYSIN DD * 

INCLUDE EXITS( IEFUJV, IEFUJI , IEFUSI , IEFUTL, IEFACTRT, IEFUJP , C 
IEFUIV,IEFUSO) 1 

IEFU83 ) 2 

ENTRY TESTEXIT 

NAME TESTEXIT 

/* 

//DATAGEN JOB MSGLEVEL=1 

// EXEC PGM=IEBUPDTE,PARM=NEW 

//SYSUT2 DD DSNAME=DGINPUT,UNIT=2314,DISP=( , KEEP ) , 

// VOLUME=SER=231400,SPACE=(TRK,( 10,5,1 ) ), 

// DCB=( LRECL=80 , BLKSIZE=400 , RECFM=FB ) 

//SYSPRINT DD SYSOUT=A 

//SYSIN DD SYSOUT=A 

./ ADD NAME=UIV 1 

(IEBDG Control Statements for IEFUIV) 

. / ADD NAME=UJV 

(IEBDG Control Statements for IEFUJV) 

./ ADD NAME=UJI 

(IEBDG Control Statements for IEFUJI) 

'./ ADD NAME=USI 

(IEBDG Control Statements for IEFUSI) 

./ ADD NAME=USO 1 

(IEBDG Control Statements for IEFUSO) 

./ ADD NAME=UTL 

(IEBDG Control Statements for IEFUTL) 

./ ADD NAME=U83 2 

(IEBDG Control Statements for IEFU83) 

. / ADD NAME=ACT 

(IEBDG Control Statements for IEFACTRT) 

Figure 39. TESTEXIT Procedure JCL (Part 1 of 2) 
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. / ADD NAME=UJP 
(IEBDG Control Statements for IEFUJP) 

. / ENDUP 

/* 

//TESTING 

//JOBLIB 

// 

// 

// PARM= ' UIV= 

//INUIV 

// 

// 

//INUJV 

// 

// 

//INUJI 

// 

// 

//INUSI 

// 
// 
//INUSO 

// 
// 
//INUTL 

// 
// 
//INU83 

// 
// 
//INACT 

// 

// 

//INUJP 

// 

// 

//O'UTUIV 

// 

// 

//OUTUJV 

// 
// 
//OUTUJI 

// 

// 

//OUTUSI 

// 

7/ 

//OUTUSO 

// 
// 
//OUTUTL 

// 
// 
//OUTU83 

// 
// 
//OUTACT 

// 
// 
//OUTUJP 

// 
// 
//MANX 

// 

// 

//SYSPRINT 

//DGPRINT 

//SYSABEND 

/* 

Figure 39. TESTEXIT Procedure JCL (Part 2 of 2) 



JOB MSGLEVEL=1 

DD DSNAME=TESTLIB,VOLUME=SER=231400, 
UNIT=23 1 4 , DISP=( OLD, KEEP ) 
EXEC PGM=TESTEXIT, 
2 , UJV=26 , UJI = 1 , USI=5 , USO=2 , UTL=5 , U83=3 , ACT=2 , UJP =2 
DD DSNAME=DGINPUT( UIV ) ,DCB=( LRECL=80, 
BLKSIZE=400,RECFM=FB),DISP=( OLD, PASS ), 
UNIT-23 1 4 , VOLUME=SER=23 1 400 
DD DSNAME=DGINPUT( UJV ) , DCB=( LRECL=80 , 
BLKSIZE=400,RECFM=FB),DISP=( OLD, PASS ), 
UNIT=23 1 4 , VOLUME=SER=23 1 400 
DD DSNAME=DGINPUT( UJI ) , DCB=( LRECL=80 , 
BLKSIZE=400 ,RECFM=FB ) , DISP=( OLD, PASS ) , 
UNIT=23 1 4 , VOLUME=SER=23 1400 
DD DSNAME=DGINPUT( USI ) , DCB=( LRECL=80 , 
BLKSIZE=400 , RECFM=FB ) , DISP=( OLD , PASS ) , 
UNIT=23 1 4 , VOLUME=SER=23 1 400 
DD DSNAME=DGINPUT( USO ) , DCB=( LRECL=80 , 
BLKSIZE=400 , RECFM=FB ) , DISP=( OLD , PASS ) , 
UNIT=23 1 4 , VOLUME=SER=23 1 400 
DD DSNAME=DGINPUT( UTL ) , DCB=( LRECL=80 , 
BLKSIZE=400,RECFM=FB),DISP=( OLD, PASS ), 
UNIT=23 1 4 , VOLUME=SER=23 1 400 
DD DSNAME=DGINPUT( U83 ) , DCB=( LRECL=80 , 
BLKSIZE=400 , RECFM=FB ) , DISP=( OLD , PASS ) , 
UNIT=23 1 4 , VOLUME=SER=23 1 400 
DD DSNAME=DGINPUT( ACT ) , DCB=( LRECL=80 , 
BLKSIZE=400 , RECFM=FB ) , DISP=( OLD, PASS ) , 
UNIT=23 1 4 , VOLUME=SER=23 1 400 
DD DSNAME=DGINPUT( UJP ) , DCB=( LRECL=80 , 
BLKSIZE=400 ,RECFM=FB ) ,DISP=( OLD, PASS ) , 
UNIT=23 1 4 , VOLUME=SER=23 1 400 

DD DSNAME=UIV(OUT),UNIT=2314,DISP=( ,PASS), 
SPACE=(TRK,( 10,5,1 ) ) , VOLUME=SER=23 1400 , 
DCB=( LRECL=80 , BLKSIZE=400 , RECFM^FB ) 
DD DSNAME=UJV(OUT),UNIT=2314,DISP=( ,PASS), 
SPACE=(TRK,( 10,5,1 ) ) , VOLUME=SER=23 1 400 , 
DCB=(LRECL=80,BLKSIZE=400,RECFM=FB) 
DD DSNAME=UJI(OUT),UNIT=2314,DISP=( ,PASS), 
SPACE-(TRK,( 10,5,1 ) ) , VOLUME=SER=23 1 400 , 
DCB=(LRECL=80,BLKSIZE=400,RECFM=FB) 
DD DSNAME=USI(OUT),UNIT=2314,DISP=( ,PASS), 
SPACE=(TRK,( 10,5,1 ) ) , VOLUME=SER=23 1 400 , 
DCB=( LRECL=80,BLKSIZE=400,RECFM=FB) 
DD DSNAME=USO( OUT ) , UNIT=23 1 4 , DISP=( , PASS ) , 
SPACE=(TRK,( 10,5,1 ) ) , VOLUME=SER=23 1 400 , 
DCB=(LRECL=80,BLKSIZE=400,RECFM=FB) 
DD DSNAME=UTL(OUT),UNIT=2314,DISP=( , PASS ) , 
SPACE=(TRK,( 10,5,1 ) ) , VOLUME=SER=23 1 400 , 
DCB=( LRECL=80 , BLKSIZE=400 , RECFM=FB ) 
DD DSNAME=U83(OUT),UNIT=2314,DISP=( ,PASS ), 
SPACE=(TRK,( 10,5,1 ) ) , VOLUME=SER=23 1 400 , 
DCB=( LRECL=1 30 , BLKSIZE= 130, RECFM=FB ) 
DD DSNAME=ACT(OUT),UNIT=2314,DISP=( ,PASS), 
SPACE=(TRK,( 10,5,1 ) ) , VOLUME=SER=23 1400 , 
DCB=(LRECL=130,BLKSIZE=130,RECFM=FB) 
DD DSNAME=UJP(OUT),UNIT=2314,DISP=( ,PASS), 
SPACE=( TRK,( 10,5,1 ) ) , VOLUME=SER=23 1 400 , 
DCB=( LRECL=1 30 , BLKSIZE- 130, RECFM=FB ) 
DD UNIT=23 1 4 , VOLUME=SER=23 1 400 , DSN=MANX , 
SPACE=(TRK,( 3,1) ), DISP=( NEW, KEEP ) , 
DCB=( BLKSIZE=200,LRECL=196 ) 
DD SYSOUT=A,DCB=(BLKSIZE=136,LRECL=132 ) 
DD SYSOUT=A 
DD SYSOUT=A 
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Using TESTEXIT 

— — T" \}™ fa* T r r T r v iT p r ^^*faw* y*v * r" ig t *fo fa* following; 



• Place your exit routines in a partitioned data set. 

• Obtain a punched deck of testexit from sysi.asamplib. 

• Modify the procedure to meet your testing requirements. 

• Execute the three jobs in the procedure. 

• Print the MANX data set if it has data. 

The procedure provided in SYSI.ASAMPLIB, without modification, can be used to 
link-edit the sample exit routines (also in SYSI.ASAMPLIB), generate sample 
parameter lists, and test the sample exit routines. You should consider linkage-editor 
and data-generator modifications in adapting the procedure to your testing 
requirements. These modifications are discussed in the topics that follow. 

Linkage Editor Modifications 

The linkage editor step of the first job (TESTEXIT), shown in Figure 39, link-edits 
the TESTEXIT program with the exit routines. You must substitute an INCLUDE 
control statement specifying the names of the exit routines you are testing. 

Data Generator Modifications 

The second job (DATAGEN), shown in Figure 39, creates a partitioned data set 
containing control statements for the IEBDG utility program. The control statements 
supplied with the procedure will generate samples of standard parameter lists. You 
should omit control statements and their associated ADD statements for any exit 
routines you are not testing. If you are testing for special conditions or require 
additional test parameters, you must make appropriate modifications and additions 
to the control statements. 

Figure 40 shows the JCL that can be used to place user written routines into 
EXITLIB, a partitioned data set. The 1 at the right side of the figure indicates exits 
available only when VS1 is used; the 2 at the right side of the figure indicates exits 
available only when VS2 is used. 

Figure 41 shows the JCL that can be used to obtain a punched deck of TESTEXIT. 

Note that you must provide control statements in such an order that the records 
subsequently generated by the IEBDG utility will be grouped as complete parameter 
lists that conform in length and format to the exit parameters previously defined in 
this chapter. (The entry code passed to exits IEFACTRT and IEFUTL in register 
must be included as a one-byte parameter at the end of the parameter lists for those 
exits.) For detailed information on the use of IEBDG control statements, refer to 
OS/VS Utilities, GC3 5-0005. 
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//UPDTE JOB MSGLEVEL=1 

// EXEC PGM=IEBUPDTE,PARM=NEW 

//SYSUT2 DD DSNAME=EXITLIB,VOLUME=SER=231400, 

// UNIT=2314,SPACE=(TRK,( 10,3,1 ) ), 

// DCB=(LRECL=80,BLKSIZE=400,RECFM=FB) 

//SYSPRINT DD SYSOUT=A 

//SYS IN DD DATA 

./ ADD NAME=IEFUIV 1 

(IEFUIV object deck) 

./ ADD NAME=IEFUJV 

(IEFUJV object deck) 

./ ADD NAME=IEFUJI 

(IEFUJI object deck) 

./ ADD NAME=IEFUSI 

(IEFUSI object deck) 

./ ADD NAME=IEFUSO 1 

(IEFUSO object deck) 

./ ADD NAME=IEFUTL 

(IEFUTL object deck) 

./ ADD NAME=IEFU83 2 

(IEFU83 object deck) 

./ ADD NAME=IEFACTRT 

(IEFACTRT object deck) 

./ ADD NAME=IEFUJP 

(IEFUJP object deck) 

. / ENDUP 
/* 

Figure 40. JCL for Entering Exit Routines into EXITLIB 



//PUNCH JOB MSGLEVEL=1 

// EXEC PGM=IEBPTPCH 

//SYSPRINT DD SYSOUT=A 

//SYSUT1 DD DSNAME=SYS1 . ASAMPLIB, DISP=( OLD, KEEP), 

// UNIT=XXXX,VOLUME=SER=XXXXXX' 

//SYSUT2 DD UNIT=2540-2 

//SYSIN DD * 

PUNCH TYP0RG=P0,MAXNAME=1 ,MAXFLDS=1 

MEMBER NAME=TESTEXIT 

RECORD FIELD=(80) 
/* 

1 The volume and unit parameters depend on your installation's request; check with your system 
programmer. 

Figure 41. JCL for Obtaining a Punched Deck of TESTEXIT 
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TESTEXIT Execution Modifications 



Thr. fhirH jnh (TPS i TINr . ), r . hnwn pirlipr in Figure 1Q ) incl udes execution of the 



TESTEXIT program. Values for the PARM parameter of the EXEC statement specify 
which exit routines are to be tested and the number of times each is to be tested. 
This parameter has the format PARM='xxx=nnn,...,xxx=nnn' where nnn is the 
number of times an exit routine is to be tested (the maximum value is 255), and xxx 
is an exit routine identifier. The DD statements to be included depend upon the exit 
routines to be tested. 

Figure 42 shows the exit-routine identifiers, specified on the EXEC statement, and 
the DD statements that must be included for each exit routine to be tested. DD 
statements for any other data sets used by your exit routines must be included in the 
TESTEXIT JCL. 



Exit Routine 


Identifier 


DD Statements 


IEFUIV 


UIV 


INUIV, OUTUIV 


IEFUJV 


UJV 


INUJV, OUTUJV 


IEFUJI 


UJI 


INUJI, OUTUJI 


IEFUSI 


USI 


INUSI, OUTUSI 


IEFUSO 


uso 


INUSO, OUTUSO 


IEFUTL 


UTL 


INUTL, OUTUTL 


IEFU83 


U83 


INU83, OUTU83 


IEFACTRT 


ACT 


INACT, OUTACT 


IEFUJP 


UJP 


INUJP, OUTUJP 


Any 




MANX, SYSPRINT, DGPRINT, SYSABEND 



Figure 42. Parameters and DD Statements for Executing TESTEXIT 
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Accounting Records 



Accounting records describe for each job and job step the user of the system, the 
resources used, and the completion status of the job or job step. The following 
record types, which constitute the group of accounting records, are described in this 
chapter: 

Record type 4 — Step Termination. 

Record type 5 — Job Termination. 

Record type 6 — Output Writer. 

Record type 26 — Job Purge (only VS2 with HASP). 

Record type 34 — TS-Step Termination (VS2 only). 

Record type 35 — Logoff (VS2 only). 

Record type 40 — Dynamic DD (VS2 only). 

Fields in these records marked "Reserved" are reserved for use by SMF and are not 
available for your use. 
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Record Type 4 
(Step Termination) 



Record type 4 is written at the normal or abnormal termination of a job step or 
when a job step is flushed during or after job initiation. The length is 1 1 7 bytes plus 
(1)8 bytes for each device entry and (2) the length of the step accounting fields. 

The job step is identified by job log number (job name and time and date that the 
reader recognized the JOB card for the job), step name, the number of the job step 
within the job, the user identification field (which may be initialized by the 
installation to facilitate subsequent sorting of records), and the program name. If 
accounting numbers (which can be alphameric) were specified in the EXEC 
statement, they are included. 

The record provides operating information such as the time the job step was started 
and completed, the CPU time, the amount of storage allocated and used, and the 
termination status, the number of records in DD DATA and DD * data sets for the 
step, the time that device allocation started, the time that the problem program was 
loaded, and the storage protect key. In vsi, input/output activity is recorded for 
each non-spooled data set for which the user has a DD statement; in VS2, it is 
recorded for all data sets for which the user has a DD statement. Each entry lists the 
EXCP count for the data set and lists the device class, type, and address. 

Data sets are recorded in the order of the step DD statements; they are not 
identified by name. A user written exit routine can record this order as each 
statement is validated if a report on data set activity is needed. 

The EXCP count appears in SMF record types 4, 14, and 15. It indicates the 
input/output activity required by the job. The EXCP count includes direct EXCPs, 
program controlled interruptions (PCls), and channel-end and abnormal-end EXCP 
returns. When chained scheduling is used, the EXCP count may vary from run to run 
for the same job. These system functions are designed to optimize input/output 
activity, and, therefore, the number of EXCPs required will depend on system and 
program interaction at the time the input/output is performed. The variation due to 
chained scheduling will be reflected in the counts for any data set using chained 
scheduling. 

The format is: 

Decimal Hexadecimal Field Data 

Displacement Displacement Size Format Contents 











1 binary 



1 


1 


1 


binary 


2 


2 


4 


binary 


6 


6 


4 


packed 


10 


A 


2 


EBCDIC 


12 


C 


2 


EBCDIC 


14 


E 


8 


EBCDIC 


22 


16 


4 


binary 


26 


1A 


4 


packed 


30 


IE 


8 


EBCDIC 


38 


26 


1 


binary 



System indicator 

Bit Meaning When Set 

6 VS2 

7 VSI 

Record type 

Time, in hundredths of a second, of end of 
step 

Date of end of step, in the form ooyydddf, 
where F is the sign 

System identification 

System model identifier 

Job name 1 

Time, in hundredths of a second, that the 
reader recognized the JOB card for this job 1 

Date that the reader recognized the JOB card 
for this job 1 

User identification field from common exit 
parameter area 

Step number (first step=1, etc.) 
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Decimal Hexadecimal Field Data 

Displacement Displacement Size Format 



Contents 



"4 binary Step initiation time, in hundredths of a 

second, which is the time of day when this 

step was selected by the initiator 

Step initiation date 

Number of card-image records in DD DATA 

and DD * data sets read by the reader for the 

job step 

Step completion code 2 

Step priority (See OS/VS Supervisor 

Services and Macro Instructions , GC27-6979) 

Program name 

Step name 

Partition or region size, in IK. blocks 3 

Reserved 

Storage used 3 

Reserved 

Storage protect key (xxxxOOOO, where xxxx is 

the key which is described under TCBPKF in 

OS/VS1 System Data Areas, SY28-0605, 

and OS/VS2 System Data Areas, 

SY28-0606) 

1 binary Step termination indicators 

Bit Meaning When Set 

Reserved 

1 vsi— Canceled by iefujv 4 
VS2 — Reserved 

2 Canceled by IEFUJ1 4 

3 Canceled by IEFUSI 4 

4 Canceled by iefactrt 4 

5 Reserved 

6 — Normal completion 
1 — ABEND 5 

7 Step not executed (that is, step was 
flushed) 

2 binary Reserved 

4 binary Device allocation start time of day, in 

hundredths of a second 
4 binary Problem program load time of day, in 

hundredths of a second 

4 binary Reserved 

2 binary Record indicators 

Bit Meaning When Set 

7 — Storage is virtual 

1 — Storage is real 
2 binary Offset from beginning of the record header to 

the relocate section 
2 binary Length of device entry portion, including this 

field, which is calculated: (8 x d) + 2, where 

d=number of devices 6 



39 



27 



43 


2B 


4 


packed 


47 


2F 


4 


binary 


51 


33 


2 


binary 


53 


35 


1 


binary 


54 


36 


8 


EBCDIC 


62 


3E 


8 


EBCDIC 


70 


46 


2 


binary 


72 


48 


2 


binary 


74 


4A 


2 


binary 


76 


4C 


6 


binary 


82 


52 


1 


binary 



83 



84 
86 

90 

94 
98 



100 
102 



53 



54 
56 

5A 

5C 

62 



64 
66 
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Decimal Hexadecimal Field Data 

Displacement Displacement Size Format Contents 

For each device, there is an eight-byte entry with the following format: 



1 


binary 


1 


binary 


2 


binary 


4 


binary 


After the device entries are the following fields: 


1 


binary 


3 


binary 


1 


binary 



Device class from UCBTYP field of unit 
control block 

Unit type from UCBTYP field of unit control 
block 

Channel/unit address 

EXCP count 



Total length of next three fields: step CPU 
time, number of accounting fields, and the 
accounting fields 

Step CPU time, in hundredths of a second 7 

Number of accounting fields 

exec statement accounting fields 8 



Relocate section: 



+0 9 4 binary Number of page-ins for this job step 

+4 4 binary Number of page-outs for this job step 

The job name and the time and date that the reader recognized the JOB card for this job 
constitute the job log number. 

The contents of the completion code field vary according to the condition of termination, as 
follows: 

X'Occc', which indicates system ABEND in the job step; ccc is the system ABEND code (see 
OS/VS Message Library: VS1 System Codes, GC38-1003 or OS/VS Message 
Library: VS2 System Codes, GC38-1008). 

X'8ccc', which indicates user ABEND in the job step; ccc is the user ABEND code. 

X'nnnn', which indicates normal completion; nnnn is the contents of the two low-order bytes 
in register 15 at termination. 

X'0000', which indicates either (1) that the job step was not executed — that is, it was flushed — 
because of an error in a preceding job step or (2) a return code of 0, indicating 
normal job completion. To distinguish between a job step flush code and a normal 
termination code and to distinguish between a system ABEND and a user ABEND, see 
the step termination indicators field. 

If the job step is run with ADDRSPC=REAL, then the partition-size and storage-used fields are 
the same and are equal to the amount of real storage requested. 

Job steps canceled by IEFUJV, IEFUJI, IEFUSI will not be executed; therefore bit 7 will also be 
turned on. Job steps canceled by iefactrt will cause subsequent job steps to be canceled; bit 7 
will be turned on for subsequent steps. 

If this bit indicates an ABEND, check the completion code field to determine the cause of the 
ABEND. A completion code of 0322 or 0522 indicates that the ABEND was caused by IEFUTL. A 
completion code of 0722 indicates that the ABEND was caused by IEFUSO. 

There is an entry for each device assigned to each non-spooled data set in VSl and for each 
device assigned to each data set in VS2. For DD *, DD data, and SYSOUT data sets, there is no 
entry. For a DD DUMMY data set the entry is set to 0. (A DD DUMMY entry results when a 
forward reference to a DD name is encountered in the input stream but a DD statement having 
that DD name is not found or when DD DUMMY is specified.) 

CPU time is not expected to be constant between different runs of the same step. One or more of 
the following factors may cause small variations in CPU time: channel program retries, CPU 
architecture (such as core buffering), cycle stealing with integrated channels, queue searching, 
(such as task switching), and pending interruptions. 

Each entry for an accounting field contains the length of the field (one byte, binary), followed 
by the field (EBCDIC). An omitted field is represented by a length indicator of 0. 

The displacement of this field is variable depending on the number of accounting fields. The 
value contained in the field at displacement 100 is the displacement of this field. 
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Record Type 5 
(Job Termination) 



Record type 5 is written at the normal or abnormal termination of a job or when a 
job step is flushed during or after job initiation. The length is 117 bytes plus the 
length of the job accounting fields. The maximum length of this record type is 26 1 
bytes. 

The job is identified by job log number, programmer name, the installation-supplied 
user identification field, input class, requested priority, and the accounting fields 
from the JOB statement. Operating information includes the start and stop time for 
processing of the job by the reader and the device type and class of the reader 
device. (The device type and class of reader device is not provided for 
foreground-initiated background jobs.) The number of records in DD DATA and DD 
* data sets for the job and the number of steps in the job are included. Job CPU time 
equals the sum of the job step CPU times. The job completion code is recorded, 
along with the storage protect key (in VS2 only) and a termination code indicating 
which of four SMF user written exit routines, if any, canceled the job. A flag marks 
each SYSOUT class used by the job. 

The format is: 



Decimal Hexadecimal Field Data 

Displacement Displacement Size Format 











binary 



1 


1 


1 


binary 


2 


2 


4 


binary 


6 


6 


4 


packed 


10 


A 


2 


EBCDIC 


12 


C 


2 


EBCDIC 


14 


E 


8 


EBCDIC 


22 


16 


4 


binary 


26 


1A 


4 


packed 


30 


IE 


8 


EBCDIC 


38 


26 


1 


binary 


39 


27 


4 


binary 


43 


2B 


4 


packed 


47 


2F 


4 


binary 


51 


33 


2 


binary 


53 


35 


1 


binary 


54 


36 


4 


binary 



58 



3A 



packed 



Contents 

System indicator 

Bit Meaning When Set 

6 VS2 

7 vsi 

Record type 

Time, in hundredths of a second, of end of 
job 

Date of end of job, in the form ooyydddf, 
where F is the sign 

System identification 

System model identifier 

Job name 1 

Time, in hundredths of a second, that the 
reader recognized the JOB card for this job 1 

Date that the reader recognized the JOB card 
for this job 1 

User identification field from common exit 
parameter area 

Number of steps in the job 

Job initiation time, in hundredths of a 
second, which is the time of day the job was 
selected by the initiator 

Job initiation date 

Number of card-image records in in DD 
data and DD * data sets for the job read by 
the reader 

Job completion code 2 

Job priority 3 

Time, in hundredths of a second, that the 
reader recognized the end of the job 

Date that the reader recognized the end of 
the job 
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Decimal Hexadecimal Field Data 

Displacement Displacement Size Format 



Contents 



62 



73 
76 



3E 



49 
4C 



1 binary Job termination indicator 



Bit 




63 


3F 5 binary 


68 


44 


binary 


69 


45 


binary 


70 


46 


binary 


71 


47 


EBCDIC 


72 


48 


binary 



binary 

EBCDIC 



Meaning When Set 

Reserved 

VSl — Canceled by exit iefujv 
VS2 — Reserved 
Canceled by exit iefuji 
Canceled by exit iefusi 
Canceled by exit iefactrt (step exit 
only) 
Reserved 

— Normal completion 
1 — A step within the job abnormally 
ended 
7 Reserved 

SYSOUT class indicator 4 

Reserved 

Reader device class from UCB 

Reader unit type from UCB 

Job input class 

Storage protect key (xxxxOOOO, where xxxx is 
the key which is described under TCBPKF in 
OS/VSl System Data Areas, SY28-0605, 
and OS/VS2 System Data Areas, 
SY28-0606) 

Reserved 

VSl — User's logon identifier. 
Non-terminal oriented jobs have an identifier 
of 'central'; terminal oriented jobs have as 
the identifier the QIDLGNID field from the 
Job Management Record for the terminal 
through which the job was submitted. 
VS2 — Reserved 
Reserved 

Length of rest of record not including this 
field 

Programmer's name 

CPU time used by the job 5 

Number of accounting fields following 

JOB statement accounting fields (variable 
length) 6 

The job name and the time and date that the reader recognized the JOB card for this job 
constitute the job log number. 

The contents of the completion code field vary according to the condition of termination of 
steps processed by the scheduler, as follows: 

X'Occc', which indicates system abend in the last job step that abnormally terminated; ccc is 
the system ABEND code (see OS/VS Message Library: VSl System Codes, 
GC38-1003 or OS/VS Message Library: VSl System Codes, GC38-1008). 

X'8ccc', which indicates user ABEND in the last job step that abnormally terminated; ccc is the 
user ABEND code. 

X'nnnn', which indicates normal completion; nnnn is the contents of the two low-order bytes 
in register 15 at termination. 

X'0000', which indicates a return code indicating normal job completion. 

Job termination indicators are provided at byte 62 of this record. For more detailed information 
on job step termination, examine record type 4. 

The job priority is normally the user-assigned priority (0-13). If the job fails while being 
scheduled (for example, during device allocation), this field shows a priority of 14, reflecting 
ABEND processing. 



83 


53 


9 


binary 


92 


5C 


1 


binary 


93 


5D 


20 


EBCDIC 


113 


71 


3 


binary 


116 


74 


1 


binary 


117 


75 
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Each bit of the indicator represents the following classes: 

Byte Byte I Byte 2 Byte 3 Byte 4 
Bit-Class — Bit - Class — Bit - Class — Bit-Class — Rit-CIn^ 



0-A 
1-B 
2-C 
3-D 
4-E 
5-F 
6-G 
7-H 



0-1 

1-J 

2-K 

3-L 

4-M 

5-N 

6-0 

7-P 



0-Q 
1-R 

2-S 
3-T 

4-U 
5-V 
6-W 

7-X 



0-Y 
1-Z 
2-0 
3-1 

4-2 
5-3 
6-4 

7-5 



0-6 
1-7 

2-8 
3-9 



Usually, this is the class specified by the SYSOUT parameter on the DD statement. 

The CPU time is the time used for the problem program by the CPU between job initiation and 
job termination. This time also includes the time spent in interrupt processing for other 
programs when this problem program is the interrupted task. 

CPU time is not expected to be constant between different runs of the same job. One or more of 
the following factors may cause small variations in CPU time: channel program retries, CPU 
architecture (such as core buffering), cycle stealing with integrated channels, queue searching, 
(such as task switching), and pending interruptions. 

Each entry for an accounting field contains the length of the field (one byte, binary), followed 
by the field (EBCDIC). An omitted field is represented by a length indicator of 0. 



Record Type 6 
(Output Writer) 



Record type 6 is written when the writer has finished processing a SYSOUT class or 
form within a class for a job. At least one output writer record is written for each 
SYSOUT class used by the job. If two or more forms are used within a class, one 
output writer record is produced for each form. The length is 57 bytes in a VS2 
system without HASP, 64 bytes in a VSl system, and 90 bytes in a VS2 system with 
HASP. In all cases, the first 57 bytes are the same. 

The output writer is identified by class and form number. The job is identified by 
job log number and the installation user identification. Output writer activity is 
recorded by a count of the number of logical records processed, the number of 
SYSOUT data sets within the class and form, writer start and end times, and a code 
indicating any input/output errors. 

If the standard writer is replaced by a user-supplied writer, SMF does not produce a 
complete record type 6. An incomplete record type 6 is written for each output class 
(but not for form changes within an output class) if the writing of records is 
allowed. In this case, the number of logical records, I/O status indicators, and form 
number fields are not provided. 

The format is: 

Decimal Hexadecimal Field Data 

Displacement Displacement Size Format Contents 











1 



binary 



binary 
binary 

packed 



10 


A 


2 


EBCDIC 


12 


C 


2 


EBCDIC 


14 


E 


8 


EBCDIC 


22 


16 


4 


binary 



System indicator 

Bit Meaning When Set 

6 VS2 

7 vsi 

Record type 

Time, in hundredths of a second, record was 
moved to SMF buffer 

Date record was moved to SMF buffer, in the 
form 00YYDDDF, where F is the sign 

System identification 

System model identifier 

Job name 1 

Time, in hundredths of a second, that the 
reader recognized the JOB card for this job 1 
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Decimal Hexadecimal Field Data 

Displacement Displacement Size Format Contents 



26 



30 



1A 



packed 



EBCDIC 



38 


26 


1 


EBCDIC 


39 


27 


4 


binary 


43 


2B 


4 


packed 


47 


2F 


4 


binary 



51 



33 



binary 



52 



53 



34 



35 



4 



binary 



EBCDIC 



The following field applies when VS1 is used: 
57 39 7 EBCDIC 



Date that the reader recognized the JOB card 
for this job 1 

User identification field from common exit 
parameter area 

SYSOUT class 

Time of SYSOUT start 

Date of SYSOUT start 

Number of records written by the writer, by 
form number and by class 

I/O status indicator in VSl and VS2 without 
HASP 

Bit Meaning When Set 

0-3 Reserved 

4 I/O discontinued (remote output only) 

5 Input error 

6 Output error 

7 Input error on sysi.sysjobqe 

I/O status indicator in VS2 with HASP 
Bit Meaning When Set 

0-4 Reserved 

5 Data input error 

6 Reserved 

7 Control block input error. 

Total number of data sets processed by writer 
for this job. In a VS2 system with hasp, the 
total number of data sets processed for this 
class and form. If multiple copies are 
produced, each copy is counted. 

Form number 



User's logon identifier. 

Non-terminal oriented jobs have an identifier 
of 'central'; terminal oriented jobs have as 
the identifier the qidlgnid field from the 
Job Management Record for the terminal to 
which the output was routed. 



The following fields only apply to VSl with HASP: 

Reserved in VS2 

HASP assigned job number 

HASP logical output device name 

FCB identifier 2 

UCS identifier 2 

Page count 2 

Output route code 

Code Meaning 

Local 

n Remote 

The job name and the time and date that the reader recognized the JOB card for this job 
constitute the job log number. 

These fields apply only to printed output. 



57 


39 


7 


binary 


64 


40 


4 


EBCDIC 


68 


44 


8 


EBCDIC 


76 


4C 


4 


EBCDIC 


80 


50 


4 


EBCDIC 


84 


54 


4 


binary 


88 


58 


2 


binary 



Record Type 26 
(Job Purge) 



Record type 26 (VS2 with HASP only) is written at the normal or abnormal 
termination of a job. The length is 196 bytes. 

The job is identified by job log number, programmer name, and HASP job number. 
Operating information includes the start and stop time for processing of the job by 
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the reader execution phase and SYSOUT output phase, HASP logical input device 
name, and output statistics. 



The format is: 

Decimal Hexadecimal Field Data 

Displacement Displacement Size Format 

1 binary 







14 







72 



binary 
binary 



4 packed 



10 


A 


2 


EBCDIC 


12 


C 


2 


EBCDIC 


14 


E 


8 


EBCDIC 


22 


16 


4 


binary 


26 


1A 


4 


packed 


30 


IE 


8 


EBCDIC 


38 


26 


1 


binary 


39 


27 


1 


binary 



40 


28 


4 


EBCDIC 


44 


2C 


8 


EBCDIC 


52 


34 


20 


EBCDIC 


72 


48 


1 


binary 


73 


49 


1 


EBCDIC 


74 


4A 


2 


binary 


76 


4C 


2 


binary 


78 


4E 


2 


binary 



80 


50 


8 


EBCDIC 


88 


58 


4 


EBCDIC 


92 


5C 


4 


EBCDIC 


96 


60 


4 


binary 


100 


64 


4 


binary 


104 


68 


4 


EBCDIC 


108 


6C 


2 


binary 


110 


6E 


2 


binary 


112 


70 


2 


binary 



binary 



116 


74 


4 


binary 


120 


78 


4 


packed 


124 


7C 


16 


binary 



Contents 

System indicator 

Bit Meaning When Set 

6 VS2 

Record type 

Time, in hundredths of a second, record was 

moved to SMF buffer 

Date record was moved to SMF buffer in the 

form ooyydddf, where F is the sign 

System identification 

System model identifier 

Job name 

Time, in hundredths of a second, that the 

reader recognized the JOB card for this job 

Date that the reader recognized the job card 

for this job 

User identification field from common exit 

parameter area 

Reserved 

Job information 

Bit Meaning When Set 
/*priority card present unless 

/*PRIORITY is * 

hasp assigned job number 

Reserved 

Programmer's name 

Reserved 

Job class from job card 

HASP execution selection priority 1 

HASP output selection priority 1 

Input route code 

Code Meaning 

Local 

n Remote 

HASP logical input device name 

Programmer's accounting number 2 

Programmer's room number 2 

Estimated execution time 2 

Estimated output (lines and cards) 2 

Output form number 2 

Print copy count 2 

Lines per page 2 

Print route code 

Code Meaning 

Local 

n Remove 

Punch route code 

Code Meaning 

Local 

n Remote 

Reader stop time 

Reader stop date 

Reserved 
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Decimal Hexadecimal Field Data 

Displacement Displacement Size Format Contents 



140 


8C 


4 


binary 


144 


90 


4 


packed 


148 


94 


4 


binary 


152 


98 


4 


packed 


156 


9C 


4 


binary 


160 


A0 


4 


packed 


164 


A4 


4 


binary 


168 


A8 


4 


packed 


172 


AC 


4 


binary 



176 



BO 



180 


B4 


184 


B8 


188 


BC 


192 


CO 



4 binary 



4 binary 

4 binary 

4 binary 

4 binary 

1 The four high order bits of the second byte contai 

2 These fields are HASP defined subfields from the 
default values assigned for this job. 



Execution start time 

Execution start date 

Execution stop time 

Execution stop date 

Output processor start time 

Output processor start date 

Output processor stop time 

Output processor stop date 

Number of input cards for job (JCL and 
SYSIN cards) 

Generated output records (during job 
execution) 

Reserved 

Printed lines 

Printed pages 

Punched cards 

n a priority number (1-15). 

accounting information field in the JOB card or 



Record Type 34 
(TS-Step Termination) 



Record type 34 (VS2 only) is written each time the TSO logoff function processes a 
job step termination. The length is 129 bytes plus (1)8 bytes for each device entry 
and (2) the length of the step accounting fields. 

This record contains the record type, time stamp (time and date), CPU identification, 
LOGON time, main storage occupancy time, count of TGETs satisfied and TPUTs 
issued, the time device allocation started, the time the problem program was loaded, 
job step CPU time, termination status, TMP name, job step name, size of region, and 
main storage used and the storage protect key. Input/output activity is recorded for 
each data set used by this job step; each entry lists the device class, type, and 
address, and the EXCP count for the data set. The data-set entry is zeros when the 
DD entry is TERM, DUMMY, or DYNAM. 

The format is: 

Decimal Hexadecimal Field Data 

Displacement Displacement Size Format Contents 











binary 



1 binary 
4 binary 

4 packed 



10 


A 


2 


EBCDIC 


12 


C 


2 


EBCDIC 


14 


E 


8 


EBCDIC 


22 


16 


4 


binary 


26 


1A 


4 


packed 


30 


IE 


8 


EBCDIC 


38 


26 


1 


binary 



System indicator 

Bit Meaning When Set 

6 VS2 

Record type 

Time, in hundredths of a second, that step 
terminated 

Date that step terminated, in the form 
ooyydddf, where F is the sign 

System identification 

System model identifier 

User identification field 

LOGON time of day in hundredths of a second 

logon date, in the form ooyydddf, where F 

is the sign. 

Reserved for user (blanks) 

Step sequence number 
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Decimal Hexadecimal Field Data 

Displacement Displacement Size Format 



Contents 



39 

43 
47 
51 
53 
54 
62 
70 
72 
74 
76 
82 

83 



27 

2B 

2F 

33 
35 
36 
3E 
46 
48 
4A 
4C 
52 

53 



84 
86 

90 

94 
100 

102 



54 
56 

5A 

5E 
64 

66 



4 binary Main storage occupancy time, in hundredths 

of a second 1 
4 binary Line-out count, number of TPUTs issued 

4 binary Line-in count, number of TGETs satisfied 

2 binary Step completion code 2 

1 binary Step dispatching priority 

8 EBCDIC Terminal Monitor Program (tmp) name 
8 EBCDIC Step name (Procedure) 

2 binary Size of region (in IK blocks) 
2 binary Reserved 

2 binary Main storage used (in IK blocks) 

6 binary Reserved 

1 binary Storage protect key (See TCBPKF, the 

protection key field in the TCB, OS/VS2 
System Data Areas, SY28-0606.) 

1 binary Step termination indicators 

Bit Meaning When Set 

Reserved 

1 Reserved 

2 Canceled by IEFUJI 3 

3 Canceled by IEFUS1 3 

4 Canceled by IEFACTRT 3 

5 Reserved 

6 — Normal completion 
1 — ABEND 

7 Step not executed (that is, step was 
flushed) 

2 binary Reserved 

4 binary Device allocation start time of day, in 

hundredths of a second 
4 binary Problem program load time of day, in 

hundredths of a second 

6 binary Reserved 

2 binary Offset from beginning of the record header to 

the relocate section 
2 binary Length of device entry portion, including this 

field, which is calculated: (8 x d) + 2, where 

d=number of devices 



For each device, there is an eight-byte entry with the following format 

1 binary 



1 binary 

2 binary 
4 binary 

After the device entries are the following fields: 

1 binary 

3 binary 
1 binary 



Relocate section: 

+0 6 

+4 

+8 
+ 12 
+ 16 



4 binary 

4 binary 

4 binary 

4 binary 

4 binary 



Device class from UCBTYP field of unit 

control block 

Unit type from UCBTYP field of unit control 

block 

Channel/unit address 

EXCP count 



Total length of next three fields: step CPU 
time, number of accounting fields, and the 
accounting fields 

Step CPU time, in hundredths of a second 4 
Number of accounting fields 
Accounting fields 5 

Number of page-ins 
Number of page-outs 
Number of swaps 
Number of TSO swap page-ins 
Number of TSO swap page-outs 
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The main storage occupancy time may be invalid if the terminal monitor program supplied by 
IBM is not used. (Refer to OS/VS2 TSO Guide to Writing a Terminal Monitor Program or a 
Command Processor, GC28-0648.) 

The contents of the completion code field varies according to the condition of termination, as 
follows: 

X'Occc', which indicates system abend; ccc is the abend code (see OS/VS Message Library: 

VS2 System Codes, GC38-1008). 
X'8ccc', which indicates user abend; ccc is the user abend code. 
X'nnnn', which indicates normal completion; nnnn is the contents of the two low-order bytes 

in register 15 at termination. 
X'0000', which indicates the last job step was not executed because of an error in the 

preceding job step. 

Abnormal or normal termination can be determined from the job-termination indicator starting 
at byte 62 of record type 35. 

Job steps canceled by iefujv, iefuji, iefusi will not be executed; therefore, bit 7 will also be 
turned on. Job steps canceled by IEFACTRT will cause subsequent job steps to be canceled; bit 7 
will be turned on for subsequent steps. 

CPU time is not expected to be constant between different runs of the same step. One or more of 
the following factors may cause small variations in CPU time: channel program retries, CPU 
architecture (such as core buffering), cycle stealing with integrated channels, queue searching, 
(such as task switching), and pending interruptions. 

Each entry in an accounting field contains the length of the field (one byte, binary) followed by 
accounting information (EBCDIC). An omitted field is represented by a length indicator of 0. 

The displacement of this field is variable depending on the number of accounting fields. The 
value contained in the field at displacement 100 is the displacement of this field. 



Record Type 35 
(LOGOFF) 



Record type 35 (VS2 only) is written each time a LOGOFF process has been 
completed. The length is 1 1 7 bytes plus the length of each job accounting field. 

This record contains the record type, time stamp (time and date), CPU identification, 
number of TGETs satisfied and TPUTs, storage protect key, session termination 
status, LOGON priority, logon sequence time, termination indicator, SYSOUT classes 
for session, and session CPU time. 

The format is: 



Decimal Hexadecimal Field Data 

Displacement Displacement Size Format 











1 



binary 



1 


1 


1 


binary 


2 


2 


4 


binary 


6 


6 


4 


packed 


10 


A 


2 


EBCDIC 


12 


C 


2 


EBCDIC 


14 


E 


8 


EBCDIC 


22 


16 


4 


binary 


26 


1A 


4 


packed 


30 


IE 


8 


EBCDIC 


38 


26 


1 


binary 


39 


27 


4 


binary 


43 


2B 


4 


binary 



Contents 

System indicator 

Bit Meaning When Set 

6 VS2 

Record type 

Time of LOGOFF 

Date of LOGOFF, in the form ooyydddf, 

where F is the sign 

System identification 

System model identifier 

User identification field 

LOGON time of day in hundredths of a second 

LOGON date, in the form ooyydddf, where F 
is the sign 

Reserved 

Number of steps in session 

Reserved 

Line-out count, number of TPUTs issued 
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Decimal Hexadecimal Field Data 

Displacement Displacement Size Format Contents 



47 2F 4 binary Line-in count, number of TGETs satisfied 

51 33 2 binary Job completion code 1 

53 35 1 binary LOGON priority 

54 36 4 binary LOGON enqueue time of day in hundredths of 

a second 

58 3A 4 packed LOGON date, in the form ooyydddf, where F 

is the sign 

62 3E 1 binary Termination indicators 

Bit Meaning When Set 

Reserved 

1 Reserved 

2 Canceled at exit IEFUJI 

3 Canceled at exit iefusi 

4 Canceled at exit iefactrt 

5 Reserved 

6 — Normal completion 

1 — ABEND 

7 Reserved 

63 3F 5 binary SYSOUT classes for session 2 (See record type 

5 for explanation of field.) 

Reserved 

Storage protect key (xxxxOOOO, where xxxx is 
the key which is described under TCBPKF in 
OS/VS2 System Data Areas, SY28-0606) 

Reserved 

Length of rest of record not including this 

field 

Reserved 

Session CPU time, in hundredths of a second 3 

Number of accounting fields 

Accounting fields 4 

The contents of the completion code field varies according to the condition of the condition of 
termination, as follows: 

X'Occc', which indicates system ABEND; ccc is the system ABEND code (see OS/VS Message 

Library: VS2 System Codes, GC38-1008). 
X'8ccc', which indicates user ABEND; ccc is the user ABEND code. 
X'nnnn', which indicates normal completion; nnnn is the contents of the two low-order types 

in register 15 at termination. 
X'0000', which indicates the last job step was not executed because of an error in the 

preceding job step. 

Abnormal or normal termination can be determined from the job termination indicator starting 
at byte 62 of this record. 

Each bit of the indicator represents the following classes: 

Byte Byte I Byte 2 Byte 3 Byte 4 
Bit-Class Bit-Class Bit-Class Bit-Class Bit-Class 



68 


44 


4 


binary 


72 


48 


1 


binary 


73 


49 


19 


binary 


92 


5C 


1 


binary 


93 


5D 


20 


EBCDIC 


113 


71 


3 


binary 


116 


74 


1 


binary 


117 


75 







0-A 


0-1 


0-Q 


0-Y 


0-6 


1-B 


1-J 


1-R 


1-Z 


1-7 


2-C 


2-K 


2-S 


2-0 


2-8 


3-D 


3-L 


t-T 


3-1 


3-9 


4-E 


4-M 


4-U 


4-2 




5-F 


5-N 


5-V 


5-3 




6-G 


6-0 


6-W 


6-4 




7-H 


7-P 


7-X 


7-5 





CPU time is not expected to be constant between different runs of the same job. One or more of 
the following factors may cause small variations in CPU time: channel program retries, CPU 
architecture (such as core buffering), cycle stealing with integrated channels, queue searching, 
(such as task switching), and pending interruptions. 

Each entry in an accounting field contains the length of the field (one byte, binary) followed by 
accounting information (EBCDIC). An omitted field is represented by a length indicator of 0. 
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Record Type 40 
(Dynamic DD) 



Record type 40 (VS2 only) is written when the dynamic allocation function 
processes a de-allocation, concatenation, or de-concatenation request. The length is 
62 bytes plus 8 bytes for each device entry. 

This record contains the record type, time stamp (time and date), CPU identification, 
LOGON time, dynamic allocation function indicators, and a data set entry. Each data 
set entry consists of the device class, unit type, channel/unit address, and EXCP 
count. The data set entry is zeros when the DD entry is TERM, DUMMY, or DYNAM. 

The format is: 

Decimal Hexadecimal Field Data 

Displacement Displacement Size Format Contents 











binary 



1 


1 


1 


binary 


2 


2 


4 


binary 


6 


6 


4 


packed 


10 


A 


2 


EBCDIC 


12 


C 


2 


EBCDIC 


14 


E 


8 


EBCDIC 


22 


16 


4 


binary 


26 


1A 


4 


packed 


30 


IE 


8 


EBCDIC 


38 


26 


1 


binary 


39 


27 


1 


binary 


40 


28 


20 


binary 


60 


3C 


2 


binary 


each device, 


there is an 


eight-byte 
1 


entry with 
binary 



1 binary 

2 binary 
4 binary 



System indicator 

Bit Meaning When Set 

6 VS2 

Record type 

Time, in hundredths of a second, that record 
was moved to SMF buffer 

Date record was moved to SMF buffer, in the 
form 00YYDDDF, where F is the sign 

System identification 

System model identifier 

User identification field 

logon time of day in hundredths of a second 

Logon date, in the form 0OYYDDDF, where F 
is the sign 

Reserved for user 

Step sequence number 

Functional indicators 
02— De-allocate 
03 — Concatenate 
04 — De-concatenate 

Reserved 

Length of rest of record including this field 

the following format: 

Device class from ucbtyp field of unit 
control block 

Unit type from ucbtyp field of unit control 
block 

Channel/unit address 

EXCP count 
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Data Set Activity Records 



Data set activity records describe the characteristics, activity, and user of data sets. 
The following record types, which constitute the group of data set activity records, 
are described in this chapter: 

• Record type 14 — INPUT or RDBACK Data Set Activity. 

• Record type 1 5 — OUTPUT, UPDAT, INOUT, or OUTIN Data Set Activity. 

• Record type 17 — Scratch Data Set Status. 

• Record type 1 8 — Rename Data Set Status. 

• Record type 20 — Job Commencement. 

Fields in these records marked "Reserved" are reserved for use by SMF and are not 
available for your use. 
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Record Type 14 

(INPUT or RDBACK Data Set Activity) 

Record type 14 is written whenever a data set that is defined by a DD statement and 
opened for INPUT or RDBACK processing by a user program is closed or processed 
by EOV. Record type 14 is not written for a data set defined by a DD * or DD DATA 
statement or a SYSOUT data set. For accounting purposes, the card image count for 
these data sets is provided in record type 4. The length varies from 288 to 6,412 
bytes, depending upon the number of volumes for the data set. 

This record contains the device type, excp count, data set indicator, data set 
organization, record format, record length, number of volumes, volume serial 
numbers, and additional information that depends on whether the data set is on a 
tape unit or a direct access device and that depends on the access method used. 

The format is: 



Decimal Hexadecimal Field Data 

Displacement Displacement Size Format 







10 

12 
14 

22 

26 
30 
38 



40 







A 
C 
E 
16 

1A 

IE 

26 



28 



binary 



binary 
binary 



4 packed 



2 


EBCDIC 


2 


EBCDIC 


8 


EBCDIC 


4 


binary 


4 


packed 


8 


EBCDIC 


2 


binary 



4 binary 



Contents 

System indicator 

Bit Meaning When Set 

6 VS2 

7 vsi 

Record type 

Time, in hundredths of a second, record was 
moved to SMF buffer 

Date record was moved to SMF buffer, in the 
form ooyydddf, where F is the sign 

System identification 

System model identifier 

Job name 1 

Time, in hundredths of a second, that the 

reader recognized the JOB card for this job 1 

Date that tf]e reader recognized the JOB card 
for this j'ob'l 

User identification field from common exit 
parameter area 

Record indicators 

Bit Meaning When Set 

Reserved 

1 Record written by EOV 

2 dasd device 

3 Temporary data set 

4 DCBDSORG=DA 

5 DCBDSORG=IS 

6 JFCDSORG=IS 

7-15 Reserved 
Segment sizes 
Byte Contents 

Size of dcb/deb segment 

1 Number of UCB segments 2 

2 Size of each UCB segment 

3 Size of extension segment 



44 



2C 



binary Reserved 
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Decimal Hexadecimal Field Data 

Displacement Displacement Size Format Contents 



48 


30 


16 


TIOT 3 segment — a portion of the TIOT, 








including: 










Byte 


Contents 











1 


TIOELNGH 
TIOESTTA 










2 


TIOEWTCT 










3 


TIOELINK. 










4 


TIOEDDNM 








i 


12 


TIOEJFCB 


t 








15 


TIOESTTC 


)-c-XJiW^^ i " 


64 


40 


176 


jfcb 3 segment — the JFCB^e'xcluding JF 








extensions 




240 


F0 


24 


dcb/DEB 3 segment 










Byte 


Contents 













DCBDSORG 










2 


DCBRECFM ^ 


()ij~'"" 








3 


DCBMACRF 


k.. -. -y } 








5 


DCBOFLGS 








6 


DCBOPTCD 










7 


Reserved 










8 


DEBOFLGS 










9 


DEBOPATB 










10 


DEBVOLSQ 










(Tape 


extension) 










12 


DCBBLK.CT / 










16 


Data set serial 


number 








22 


Reserved 





264 



108 



24 



(DASD extension) 

12 Relative track (ttr) of the last record 

read or written (left adjusted and 
padded with zeros) 

16 Number of tracks released by the 

dadsm routine 

20 Number of extents released by the 
dadsm routine 

21 Reserved 

UCB 3 segment (24 bytes for each UCB in the 

data set) 

Bytes Contents 

UCBCHA 

1 UCBUA 

2 SRTEVOLI/DCELVOLI 
8 UCBTYP 

12 SRTESTAB/DCELSTAB 

1 3 Number of extents 

14 Reserved 

16 EXCP count by problem program 4 >.,/ 

(Tape extension) 

20 SRTEFSCT 

22 SRTEFSEQ 

(DASD extension) 

20 Total number of tracks allocated on 

the device 
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Decimal Hexadecimal Field Data 

Displacement Displacement Size Format Contents 

28 



ISAM Extension for dcbdsorG; 


= IS 


Byte 


Contents 







Reserved 




2 


DCBMAC 




3 


DCBNLEV 




4 


DCBRORG3 




8 


DCBNREC 




12 


DCBRORG2 




14 


DCBNOREC 




16 


DCBRORG1 




18 


Reserved 




19 


DEBNIEE 




20 


DEBNPEE 




21 


DEBNOEE 




22 


Number of cylinders in 
Index Area 


Independent 


24 


Number of cylinders in 


Prime Area 


26 


Number of cylinders in 
OVFL Area 


Independent 



1 The job name and the time and date that the reader recognized the JOB card for this job 
constitute the job log number. 

2 For ISAM data sets, the number of UCB segments in the order stated is one for the index extent, 
one per volume for primary extents, and one for the overflow extent. 

For BPAM concatenated data sets used as input, there is one UCB segment for each data set in 
the concatenated data set. 

3 For further information about the contents of the tiot, JFCB, dcb, DEB, and UCB, refer to 
OS/VSl System Data Areas, SY28-0605, and OS/VS2 System Data Areas, SY28-0606. 

4 The EXCP count accumulates over the entire step. Therefore, if a data set is opened and closed 
twice during a single step, the count in the second record is the sum of all EXCPs for both uses 
of the data set. The EXCP count in the last type 14 record for the step is equal to the 
corresponding entry for the data set in the type 4 record. 

Record Type 1 5 

(OUTPUT, UPDAT, INOUT, or OUTIN Data Set Activity) 

Record type 15 is written whenever a data set that has been defined by a DD 
statement and opened for OUTPUT, UPDAT, INOUT, or OUTIN processing by a user 
program is closed or processed by EOV. The length varies from 288 to 6,412 bytes, 
depending upon the number of volumes for the data set. Record type 15 is not 
written for data sets defined as SYSOUT data sets on DD statements. For accounting 
purposes, the SYSOUT logical record count is included in record type 6. 

This record contains the device type, EXCP count, data set indicator, data set 
organization, record format, record length, number of volumes, volume serial 
numbers, and additional information that depends on whether the data set is on a 
tape unit or a direct access device and that depends on the access method used. 

The format is: 

Decimal Hexadecimal Field Data 

Displacement Displacement Size Format Contents 





1 



1 


1 
1 


binary 
binary 


System indicator 

Bit Meaning When Set 

6 VS2 

7 VSl 
Record type 


2 


2 


4 


binary 


Time, in hundredths of a second, record was 
moved to SMF buffer 


6 


6 


4 


packed 


Date record was moved to SMF buffer, in the 
form ooyydddf, where F is the sign 





A 


2 


EBCDIC 


System identification 
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Decimal Hexadecimal Field Data 

Displacement Displacement Size Format Contents 



12 


C 


2 


EBCDIC 


System model identifier 


14 


E 


8 


EBCDIC 


Job name 1 


22 


16 


4 


binary 


Time, 
reader 


in hundredths of a second, that the 
recognized the JOB card for this job 1 


26 


1A 


4 


packed 


Date that the reader recognized the JOB card 
for this job 1 


30 


IE 


8 


EBCDIC 


User identification field from common exit 
parameter area 


38 


26 


2 


binary 


Record indicators 










Bit 


Meaning When Set 











1 

2 
3 
4 
5 
6 
7-15 


Reserved 

Record written by EOV 
DASD device 
Temporary data set 

DCBDSORG=DA 

DCBDSORG=IS 

JFCDSORG=IS 

Reserved 


40 


28 


4 


binary 


Segment sizes 










Byte 


Contents 











1 

2 
3 


Size of DCB/DEB segment 
Number of UCB segments 2 
Size of each UCB segment 
Size of extension segment 


44 


2C 


4 


binary 


Reserved 


48 


30 


16 




TIOT 3 segment — a portion of the TlOT, 
including: 










Byte 


Contents 













TIOELNGH 










1 

2 


TIOESTTA 
TIOEWTCT 










3 
4 
12 
15 


TIOELINK 
TIOEDDNM 
TIOEJFCB 
TIOESTTC 


64 


40 


176 




JFCB 3 segment — the JFCB, excluding JFCB 
extensions 


240 


F0 


24 




DCB/DEB 3 segment 










Byte 


Contents 












2 
3 
5 
6 
7 


DCBDSORG 
DCBRECFM 
DCBMACRF 
DCBOFLGS 
DC BO PTC D 

Reserved 










8 
9 
10 


DEBOFLGS 
DEBOPATB 
DEBVOLSQ 










(Tape extension) 










12 
16 

22 


DCBBLKCT 

Data set serial number 

Reserved 
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Decimal Hexadecimal Field Data 

Displacement Displacement Size Format Contents 



240 



F0 



24 



264 



108 



24 



28 



DCB/DEB 3 segment 
(dasd extension) 

12 Relative track (ttr) of the last record 

read or written (left adjusted and 
padded with zeros) 

16 Number of tracks released by the 

dadsm routine 

20 Number of extents released by the 
DADSM routine 

21 Reserved 

UCB 3 segment (24 bytes for each UCB in the 
data set) 

Byte Contents 





1 


UCBCHA 
UCBUA 




2 


SRTEVOLI/DCELVOLI 




8 


UCBTYP 




12 


SRTESTAB/DCELSTAB 




13 


Number of extents 




14 


Reserved 




16 


EXCP count by problem 


i program 4 


(Tape 


extension) 




20 


SRTEFSCT 




22 


SRTEFSEQ 




(dasd 


extension) 




20 


Total number of tracks 
the device 


allocated on 


ISAM extension for DCBDSORG= 


= IS 


Byte 


Contents 







Reserved 




2 


DCBMAC 




3 


DCBNLEV 




4 


DCBRORG3 




8 


DCBNREC 




12 


DCBRORG2 




14 


DCBNOREC 




16 


DCBRORG1 




18 


Reserved 




19 


DEBNIEE 




20 


DEBNPEE 




21 


DEBNOEE 




22 


Number of cylinders in 
Index Area 


Independent 


24 


Number of cylinders in 


Prime Area 


26 


Number of cylinders in 
OVFL Area 


Independent 



1 The job name and the time and date that the reader recognized the JOB card for this job 
constitute the job log number. 

2 For ISAM data sets, the number of UCB segments in the order stated is one for the index extent, 
one per volume for primary extents, and one for the overflow extent. 

3 For further information about the contents of the TIOT, JFCB, DCB, DEB, and UCB, refer to 
OS/VS1 System Data Areas , SY28-0605, and OS/VS2 System Data Areas , SY28-0606. 

4 The EXCP count accumulates over the entire step. Therefore, if a data set is opened and closed 
twice during a single step, the count in the second record is the sum of all EXCPs for both uses 
of the data set. The EXCP count in the last type 15 record for the step is equal to the 
corresponding entry for the data set in the type 4 record. 
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Record Type 17 

(Scratch Data Set Status) 



Record type 17 is written whenever a user data set is scratched. (A user's data set is 
one defined by a user's DD statement either explicitly or implicitly. When a user's 
DD statement defines a volume, all data sets on that volume are implicitly defined.) 
The REC parameter determines whether record type 17 is created for only 
non-temporary data sets or for both temporary and non-temporary data sets. The 
length is 88 bytes plus 8 bytes for each volume. The length varies from 96 to 2,136 
bytes. 

This record contains the data set name, number of volumes, and volume serial 
numbers. 

The format is: 

Decimal Hexadecimal Field Data 

Displacement Displacement Size Format Contents 











1 



binary 



binary 
binary 

packed 



10 


A 


2 


EBCDIC 


12 


C 


2 


EBCDIC 


14 


E 


8 


EBCDIC 


22 


16 


4 


binary 



System indicator 

Bit Meaning When Set 

6 VS2 

7 vsi 

Record type 

Time, in hundredths of a second, record was 

moved to SMF buffer 

Date record was moved to SMF buffer in the 
form ooyydddf, where F is the sign 

System identification 

System model identifier 

Job name 1 

Time, in hundredths of a second, that the 
reader recognized the JOB card for this job 1 

Date that the reader recognized the JOB card 
for this job 1 

User identification field from common exit 
parameter area 

Reserved 

Data set name 

Reserved 

Number of volumes 

Volume serial number (eight bytes for each 

volume) 

Byte Contents 

0-1 Reserved 

2-7 Volume serial number (EBCDIC) 

The job name and the time and date that the reader recognized the JOB card for this job 
constitute the job log number. 



26 

30 

38 
40 
84 
87 



1A 
IE 

26 

28 
54 
57 
58 



4 packed 



8 


EBCDIC 


2 


binary 


44 


EBCDIC 


3 


binary 


1 


binary 
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Record Type 18 
(Rename Data Set Status) 



Record type 18 is written whenever any data set is renamed. The length is 132 bytes 
plus 8 bytes for each volume. The length varies from 140 to 2,180 bytes, depending 
upon the number of volumes for the data set. 

This record contains the old data set name, new data set name, number of volumes, 
and volume serial numbers. 

The format is: 

Decimal Hexadecimal Field Data 

Displacement Displacement Size Format Contents 







26 







1A 



1 



binary 



binary 
binary 



4 packed 



10 


A 


2 


EBCDIC 


12 


C 


2 


EBCDIC 


14 


E 


8 


EBCDIC 


22 


16 


4 


binary 



packed 



System indicator 

Bit Meaning When Set 

6 VS2 

7 vsi 

Record type 

Time, in hundredths of a second, record was 
moved to SMF buffer 

Date record was moved to SMF buffer, in the 
form 0OYYDDDF, where F is the sign 

System identification 

System model identifier 

Job name 1 

Time, in hundredths of a second, that the 
reader recognized the JOB card for this job 1 

Date that the reader recognized the JOB card 
for this job 1 

User identification field from common exit 
parameter area 

Reserved 

Old data set name 

New data set name 

Reserved 

Number of volumes 

Volume serial number (eight bytes for each 

volume) 

Byte Contents 

0-1 Reserved 

2-7 Volume serial number (EBCDIC) 

The job name and the time and date that the reader recognized the JOB card for this job 
constitute the job log number. 



30 


IE 


8 


EBCDIC 


38 


26 


2 


binary 


40 


28 


44 


EBCDIC 


84 


54 


44 


EBCDIC 


128 


80 


3 


binary 


131 


83 


1 


binary 


132 


84 
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Record Type 20 

(Job Commencement) 



Record type 20 is written at job initiation when data set accounting and/or direct 
access volume information is specified. In VSl, if a job is canceled at IEFUJV or 
iefuji, this record is not written. In VS2, if a job is canceled at iefuji, this record is 
not written. The length is 61 bytes plus the length of the job accounting fields. 

Note: For a job canceled at IEFUIV in VSl and IEFUJV in VS2 no records for the job 
are written. 

This record contains the record type, time stamp (time and date), CPU identification, 
job log number (job name, entry time, and entry date), programmer's name, user 
identification, number of accounting fields on the job statement, and accounting 
fields. 

The format is: 

Decimal Hexadecimal Field Data 

Displacement Displacement Size Format Contents 











1 



binary 



binary 
binary 



4 packed 



10 


A 


2 


EBCDIC 


12 


C 


2 


EBCDIC 


14 


E 


8 


EBCDIC 


22 


16 


4 


binary 



System indicator 

Bit Meaning When Set 

6 VS2 

7 vsi 

Record type 

Time, in hundredths of a second, record was 
moved to smf buffer 

Date record was moved to SMF buffer, in the 
form OOYYDDDF, where F is the sign 
System identification 
System model identifier 
Job name 1 

Time, in hundredths of a second, that the 
reader recognized the JOB card for this job 1 

Date that the reader recognized the JOB card 
for this job 1 

User identification field from common exit 
parameter area 

Reserved 

Programmer's name 

Number of accounting fields 

Accounting fields 2 

1 The job name and the time and date that the reader recognized the JOB card for this job 
constitute the job log number. 

2 Each entry for an accounting field contains the length of the field (one binary byte), followed 
by the field (EBCDIC). An omitted field is represented by a length indicator of 0. 



26 



30 



1A 



IE 



4 packed 



EBCDIC 



38 


26 


2 


binary 


40 


28 


20 


EBCDIC 


60 


3C 


1 


binary 


61 


3D 
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Volume Records 



Volume records describe the space available on direct access volumes and certain 
error statistics for tape volumes (ESV). The following record types, which constitute 
the group of volume records, are described in this chapter: 

• Record type 19 — Direct Access Volume. 

• Record type 21 — ESV. 

Fields in these records marked "Reserved" are reserved for use by SMF and are not 
available for your use. 
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Record Type 19 
(Direct Access Volume) 



Record type 19 is written for each direct access device on line at I PL and when a 
HALT EOD command or SWITCH SMF command is processed. Record type 19 is also 
written for a user volume whenever it is demounted. The length is 64 bytes. 

This record contains the volume serial number, VTOC address, owner identification 
number, device type, number of unused alternate tracks, number of unallocated 
cylinders and tracks, number of cylinders and tracks in the largest free extent, 
number of unallocated extents, channel and unit address, and module identification 
for the 2314 and 3330 disk drives. 

Note: Record type 19 is not created for DOS volumes used under the operating 
system. Synchronization of clocks is essential in a shared file environment in order 
to determine the latest status of the shared file. 

The format is: 



Decimal Hexadecimal Field Data 

Displacement Displacement Size Format 











binary 



1 


1 


1 


binary 


2 


2 


4 


binary 


6 


6 


4 


packed 


10 


A 


2 


EBCDIC 


12 


C 


2 


EBCDIC 


14 


E 


8 





22 


16 


10 


EBCDIC 


32 


20 


4 


binary 


36 


24 


5 


binary 


41 


29 


1 


binary 


42 


2A 


2 


binary 


44 


2C 


2 


binary 


46 


2E 


2 


binary 


48 


30 


2 


binary 


50 


32 


2 


binary 


52 


34 


2 


binary 


54 


36 


2 


binary 


56 


38 


2 


binary 


58 


3A 


2 


binary 


60 


3C 


2 


binary 


62 


3E 


2 


binary 



Contents 

System indicator 

Bit Meaning When Set 

6 VS2 

7 vsi 

Record type 

Time, in hundredths of a second, record was 
moved to SMF buffer 

Date record was moved to SMF buffer in the 
form ooyydddf, where F is the sign 

System identification 

System model identifier 

Volume serial number 

Byte Contents 

0,1 Reserved 

2-7 Volume serial number (EBCDIC) 

Owner identification of direct access volume 

Device type 

VTOC address 

DS4VTOCI 

Number of DSCBs 

Number of format DSCBs 

Number of unused alternate tracks 

Number of unallocated cylinders 

Number of unallocated tracks 

Number of cylinders in the largest free extent 

Number of tracks in the largest free extent 

Number of unallocated extents 

Reserved 

Channel and unit address in the form X'Ocuu' 

where c is the channel address and uu is the 

unit address 

Module identification or drive number 
indicating physical identity of devices having 
movable address plugs. This field is taken 
from bits 2-7 of sense byte 4 for these devices. 
(Refer to the component descriptions of these 
devices for the meaning of sense byte 4.) 
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Record Type 21 
(ESV) 



Record type 21 is written by the Error Statistics by Volume (ESV) option when a 
user data set on magnetic tape is demounted. This record is written to the SMF data 
set only if ESV=SMF is specified in the SCHEDULR macro instruction at system 
generation. The length is 44 bytes. 

This record contains error statistics information about the tape volume which can be 
analyzed, formatted, and printed by IFHSTATR or your own user routine. (See 
"IFHSTATR" in OS/VS Utilities, GC35-0005.) In VS1, statistics are recorded for 
only the first data set on a volume. In VS2, statistics are recorded for the entire 
volume during the period of time that the volume is mounted regardless of the 
number of data sets on the volume being accessed and regardless of the number of 
CLOSE macro instructions issued. 



The format is: 

Decimal Hexadecimal 

Displacement Displacement 











Field Data 
Size Format 

1 binary 



binary 
binary 



4 packed 



Contents 

System indicator 

Bit Meaning When Set 

6 VS2 

7 vsi 

Record type 

Time, in hundredths of a second, record was 
moved to SMF buffer 

Date record was moved to SMF buffer, in the 
form OOYYDDDF, where F is the sign 

System identification 

System model identifier 

Length of rest of record including this field 

Volume serial number 

Channel/unit address 

UCB type 

Number of temporary read errors 

Number of temporary write errors 

Number of start l/Os 

Number of permanent read errors 

Number of permanent write errors 

Number of noise blocks 

Number of erase gaps 

Number of cleaner actions 

Tape density (Format of this field is the same 
as that of dcbden, the tape density field in 
the dcb.) 

Block size or 1 

Reserved 

This field is if recfm in the dcb specifies variable or unblocked records, or if you are doing 
your own excp processing. 



10 


A 


2 


EBCDIC 


12 


C 


2 


EBCDIC 


14 


E 


2 


binary 


16 


10 


6 


EBCDIC 


22 


16 


2 


binary 


24 


18 


4 


binary 


28 


1C 


1 


binary 


29 


ID 


1 


binary 


30 


IE 


2 


binary 


32 


20 


1 


binary 


33 


21 


1 


binary 


34 


22 


1 


binary 


35 


23 


2 


binary 


37 


25 


2 


binary 


39 


27 


1 


binary 


40 


28 


2 


binary 


42 


2A 


2 
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System Use Records 



System use records describe the configuration and SMF options in effect, give system 
statistics, and record certain events. The following record types, which constitute the 
group of system use records, are described in this chapter: 

Record type — I PL. 

Record type 1 — Wait Time. 

Record type 2 — Dump Header. 

Record type 3 — Dump Trailer. 

Record type 7 — Data Lost. 

Record type 8 — I/O Configuration. 

Record type 9 — VARY ONLINE. 

Record type 10 — Allocation Recovery. 

Record type 1 1 — VARY OFFLINE. 

Record type 12 — End-of-Day. 

Record type 13 — Dynamic Storage Configuration (VSl only). 

Record type 30— Start TS (VS2 only). 

Record type 31 — TIOC Initialization (VS2 only). 

Record type 32 — Driver (VS2 only). 

Record type 33 — Driver Modify (VS2 only). 

Record type 41 — Modify TS (VS2 only). 

Record type 42— Stop TS (VS2 only). 

Record type 43 — RTAM Start (VSl only). 

Record type 44 — RTAM Modify (VSl only). 

Record type 45 — RTAM Stop (VSl only). 

Record type 47 — LOGON (VSl only). 

Record type 48 — LOGOFF (VSl only). 

Record type 49 — RTAM Integrity (VSl only). 

Fields in these records marked "Reserved" are reserved for use by SMF and are not 
available for your use. 
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Record Type 
(IPL) 



Record type is written after every IPL of the system. It includes the virtual and real 
storage size and the SMF options in effect. The length is 31 bytes. 

The format is: 

Decimal Hexadecimal Field Data 

Displacement Displacement Size Format Contents 







22 
26 







10 


A 


2 


EBCDIC 


12 


C 


2 


EBCDIC 


14 


E 


4 


binary 



12 

16 
1A 



27 



IB 



1 binary System indicator 

Bit Meaning When Set 

6 VS2 

7 vsi 

1 binary Record type 

4 binary Time, in hundredths of a second, record was 

moved to smf buffer 

4 packed Date record was moved to SMF buffer, in the 
form 00YYDDDF, where F is the sign 

System identification 

System model identifier 

Limit in minutes of continuous wait time for 
the job (from value specified on JWT 
parameter) 

4 binary Number of bytes in smf buffer from value 
specified in BUF parameter 

4 binary Number of 1K bytes in virtual storage 

I binary SMF options 

Bit Meaning When Set 

System and job data to be collected 

System, job, and step data to be 

collected 

Exits requested 

Data set accounting 

Volume accounting 

Reserved 

Temporary data set scratch records 

Reserved 

4 binary Number of IK bytes in real storage 







Record Type 1 
(System Statistics) 



Record type 1 is written after every IPL of the system and at the first job or job step 
termination following the expiration of a ten-minute interval. 1 The length is 34 bytes 
in vsi; 54 bytes in VS2. 

Elapsed time of day (ordinary CPU-processing time) is divided into ten-minute 
intervals for the purpose of collecting system statistics. A system statistics record is 
written at SMF initialization and contains the CPU wait time and paging statistics 
accumulated during the IPL process. This record marks the beginning of the first 
ten-minute interval. Subsequent system statistics records are written at the first job 
or job step termination following the expiration of a ten-minute interval. Each 
system statistics record contains the wait time and paging counts accumulated during 
all the ten-minute intervals that expired since the last system statistics record was 
written and the time of day that the last ten-minute interval ended. At job and step 
termination, a check is made to see whether at least one ten-minute interval has 



1 If a halt command or switch command is issued before the completion of a ten-minute 
interval, the wait time collected for that interval is written in a record type 12. If the system 
continues processing, the next record type 1 contains the wait-time accumulated from the HALT 
command or SWITCH command to the expiration of the ten-minute interval. 
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expired since the last system statistics record was written. Processing continues, as 
follows: 



• If a ten-minute interval has expired, a system statistics record is created, and the 
wait time and paging count accumulated during the expired ten-minute interval 
are moved into the record. 

• If more than one ten-minute interval has expired, the wait time and paging counts 
accumulated during the expired ten-minute intervals since the last system 
statistics record was created is moved into the record. 

• If a ten-minute interval has not expired, no system statistics record is created. 

Note that the only connection between a job or step and system statistics records is 
that the termination of a job or step causes SMF to check whether at least one 
ten-minute interval has expired. 

Figure 43 shows how wait time is collected. The process is similar for collecting 
system paging statistics. When job/step A terminates, three ten-minute intervals 
have expired. The total wait time collected in these three intervals (783 seconds) is 
moved to a system statistics record. When job/step B terminates, no ten-minute 
interval has expired since the last system statistics record was written; therefore, a 
system statistics record is not written. When job/step C terminates, three intervals 
have expired. The total wait time collected in these intervals (809 seconds) is moved 
to a system statistics record. 



Ten-Minute Intervals 1 


Wait Time Interval 


217 


263 


303 


342 


265 


202 


360 


Wait Time Collected 2 in a 
Record Type 1 


783 




809 




Job/Step Termination 


A 


B 


C 





1 Elapsed time is divided into ten-minute intervals by SMF and the wait time is collected in seconds 
for each successive interval. 

2 Collected by totaling the time found in each wait time interval completed before or at each 
job/step termination. A record type 1 is written when a job/step terminates if a ten-minute 
interval has expired. 

Figure 43. Wait Time Collection 

Note: If the stop button is pushed to suspend CPU processing on an IBM 
System/370, (1) timing of the ten-minute interval is suspended, but (2) the 
Time-of-Day clock continues to run. The ten-minute interval is based on 
CPU-processing time, not on the Time-of-Day clock. Therefore, the wait time 
interval reflected by time of day (time stamp) is equal to the normal ten-minute 
CPU-processing interval plus the time that CPU processing was stopped. 

There is a relationship among wait time, elapsed time, job time, and system time, as 
shown in the following formula: 

Elapsed time = Job time + Wait time + System time 

Elapsed time is the length of the measurement interval. It can be obtained by 
calculating the difference between the time stamp on the first type 1 record and the 
time stamp on the type 12 record written when a HALT command or a SWITCH 
command was processed after all jobs processed during the measurement interval 
have terminated. 
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Job time is the total time required by all jobs processed in the interval reflected by 
elapsed time. This value can be obtained by summing the CPU time values from all 
the type 5 records produced during the elapsed time. 

Wait time is the total CPU wait time collected during the interval. This value can be 
obtained by summing the wait time values from the type 12 record written at the 
end of the interval and all but the first type 1 records. 

System time is the total time required to process system tasks. This value can be 
calculated when the three other values are known. 

The time stamp in the header of a system statistics record reflects the time at which 
the record was written, not the expiration time of the last ten-minute interval. The 
expiration time field after the header gives the ending time of the interval. 

The format is: 

Decimal Hexadecimal Field Data 

Displacement Displacement Size Format Contents 











1 



binary 



1 


1 


1 


binary 


2 


2 


4 


binary 


6 


6 


4 


packed 


10 


A 


2 


EBCDIC 


12 


C 


2 


EBCDIC 


14 


E 


4 


binary 


18 


12 


4 


binary 


22 


16 


4 


binary 


26 


1A 


4 


binary 


30 


IE 


4 


binary 


followi 


ng fields apply only 


when 


VS2 is use 


34 


22 


4 


binary 


38 


26 


4 


binary 



42 

46 
50 



2A 

2E 
32 



4 binary 



binary 
binary 



System indicator 

Bit Meaning When Set 

6 VS2 

7 vsi 

Record type 

Time, in hundredths of a second, record was 
moved to SMF buffer 

Date record was moved to SMF buffer in the 
form ooyydddf, where F is the sign 

System identification 

System model identifier 

System wait time, in hundredths of a second, 
for ten-minute intervals that have expired 
since the last record type 1 or 12 

Expiration time of the end of the interval 
whose statistics are reported in this record 

Total page-ins for the entire system during 
the interval 

Total page-outs for the entire system during 
the interval 

Total pages reclaimed for the entire system 
during the interval 



Total number of regions swapped 

Accumulated number of pages paged in when 
regions are swapped 

Accumulated number of pages paged out 
when regions are swapped 

Number of regions migrated 

Accumulated number of pages paged out 
when regions are migrated 



Record Type 2 
(Dump Header) 



Record type 2 is written by the SMF dump program at the beginning of a dump data 
set. The length is 14 bytes. 

This record consists of only the standard record header. It indicates the beginning of 
a dump of the SMF data set from a direct access device to tape. Record type 2 is 
written directly to the dump data set by the SMF dump program. 
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The format is: 



Decimal 



Hexadecimal Field Data- 



Displacement Displacement Size Format Contents 











binary 



1 


1 


1 


binary 


2 


2 


4 


binary 


6 


6 


4 


packed 


10 


A 


2 


EBCDIC 


12 


C 


2 


EBCDIC 



System indicator 

Bit Meaning When Set 

6 VS2 

7 vsi 

Record type 

Time, in hundredths of a second, record was 
written to the dump data set 

Date record was written to the dump data set, 
in the form ooyydddf, where F is the sign 

System identification 

System model identifier 



Record Type 3 
(Dump Trailer) 



Record type 3 is written by the SMF dump program at the end of a dump data set. 
The length is 14 bytes. 

This record consists of only the standard record header. It marks the end of a dump 
of the SMF data set from a direct access device to tape. Record type 3 is written 
directly to the dump data set by the SMF dump program. 

The format is: 

Decimal Hexadecimal Field Data 

Displacement Displacement Size Format Contents 







10 

12 







1 


binary 


System indicator 

Bit Meaning When Set 

6 VS2 

7 vsi 


1 


binary 


Record type 


4 


binary 


Time, in hundredths of a second, record was 
written to the dump data set 


4 


packed 


Date record was written to the dump data set, 
in the form OOYYDDDF, where F is the sign 


2 


EBCDIC 


System identification 


2 


EBCDIC 


System model identifier 



Record Type 7 
(Data Lost) 



Record type 7 is the first record built when an SMF data set becomes available after 
a period when no SMF data sets were available for recording. Data existing in the 
SMF buffers is written to the newly available SMF data set before record type 7 is 
built in a buffer. Consequently, record type 7 is not the first record in the data set. 
The length is 24 bytes. 

This record contains a count of SMF records not written, and the start and end times 
of the period during which no records were written. (The end time is the time 
recorded in the record header.) 

Note: The time stamp of record types 4, 5, 34, and 35 reflects the time of the end of 
the job or job step instead of the time that the record was moved to the buffer. 
Therefore, it is possible for the first record after the record type 7 to have a time 
stamp earlier than that of the type 7. 
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The format is: 



Decimal Hexadecimal Field Data 

Displacement Displacement Size Format Contents 







20 







14 



1 



binary 



binary 
binary 

packed 



10 


A 


2 


EBCDIC 


12 


C 


2 


EBCDIC 


14 


E 


2 


binary 


16 


10 


4 


binary 



4 packed 



System indicator 

Bit Meaning When Set 

6 VS2 

7 vsi 

Record type 

Time, in hundredths of a second, record was 
built in smf buffer 

Date record was built in SMF buffer in the 
form ooyydddf, where F is the sign 

System identification 

System model identifier 

Number of SMF records lost 

Time, in hundredths of a second, of start of 
data loss 

Starting date at which no data set was 
available for recording SMF records, in the 
form ooyydddf, where F is the sign 



Record Type 8 
(I/O Configuration) 



Record type 8 is written after completion of I PL, following the SET DATE command. 
The length is 16 bytes plus 4 bytes for each device online at I PL. 

This record consists of the standard record header and an entry describing each 
device that is on line at IPL. Devices are identified by device class, unit type, and 
device address. 



The format is: 

Decimal Hexadecimal Field 

Displacement Displacement Size 







2 

6 

10 
12 
14 







Data 

Format Contents 

binary System indicator 

Bit Meaning When Set 

6 VS2 

7 vsi 

binary Record type 

binary Time, in hundredths of a second, record was 
moved to SMF buffer 

packed Date record was moved to SMF buffer in the 
form ooyydddf, where F is the sign 

EBCDIC System identification 

EBCDIC System model identifier 

binary Length of rest of record including this field 



For each online device, there is a four-byte entry with the following format: 

1 binary Device class from ucbtyp field of unit 

control block 

1 binary Unit type from ucbtyp field of unit control 
block 

1 binary Channel address 

1 binary Unit address 
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Record Type 9 
(VA R Y ONL I NE) 



Record type 9 is written when a VARY ONLINE command is processed. The length is 
1 6 bytes plus 4 bytes for each device entry. 



Record Type 1 
(Allocation Recovery) 



This record identifies the system resource being added to the configuration. 
The format is: 



Decimal Hexadecimal Field 

Displacement Displacement Size 







10 
12 

14 







Data 

Format Contents 

binary System indicator 

Bit Meaning When Set 

6 VS2 

7 VS1 

binary Record type 

binary Time, in hundredths of a second, record was 
moved to SMF buffer 

packed Date record was moved to SMF buffer in the 
form ooyydddf, where F is the sign 

EBCDIC System identification 

EBCDIC System model identifier 

binary Length of rest of record including this field 



For each device added, there is a four-byte entry with the following format: 

1 



binary 

binary 

binary 
binary 



Device class from UCBTYP field of unit 
control block 

Unit type from UCBTYP field of unit control 
block 

Channel address 

Unit address 



Record type 10 is written after successful allocation. The length is 40 bytes plus 4 
bytes for each device entry. 

This record identifies the device brought on line, or otherwise made available, by 
device class, unit type, and device address. The job requiring the allocation is 
identified by job name, reader start time, and the user identification field. The 
record is not produced if the operator cancels the job instead of attempting 
recovery. 

The format is: 

Decimal Hexadecimal Field Data 

Displacement Displacement Size Format Contents 







10 

12 
14 







1 


binary 


System indicator 






Bit Meaning When Set 






6 VS2 






7 vsi 


1 


binary 


Record type 


4 


binary 


Time, in hundredths of a second, record was 
moved to SMF buffer 


4 


packed 


Date record was moved to SMF buffer, in the 
form OOYYDDDF, where F is the sign 


2 


EBCDIC 


System identification 


2 


EBCDIC 


System model identifier 



8 EBCDIC Job name 1 
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Decimal Hexadecimal Field Data 

Displacement Displacement Size Format 



22 



26 



30 



38 



16 



1A 



IE 



26 



binary 
packed 

EBCDIC 

binary 



Contents 

Time, in hundredths of a second, that the 
reader recognized the JOB card for this job 1 

Date that the reader recognized the JOB card 
for this job 1 

User identification field from common exit 
parameter area 

Length of rest of record including this field 



Record Type 1 1 
(VARY OFFLINE) 



For each device being made available, there is a four-byte entry with the following format: 

1 binary Device class from UCBTYP field of unit 

control block 

1 binary Unit type from UCBTYP field of unit control 

block 

1 binary Channel address 

1 binary Unit address 

1 The job name and the time and date that the reader recognized the JOB card for this job 
constitute the job log number. If allocation recovery is for a system task, the job name field 
contains blanks and the reader start time and reader start date fields will contain binary zeros. 



Record type 1 1 is written when a VARY OFFLINE command is processed. The length 
is 16 bytes plus 4 bytes for each device entry. 

This record identifies the system resource being removed from the configuration. 

The format is: 

Decimal Hexadecimal Field 

Displacement Displacement Size 







10 
12 

14 







1 



Data 




Format 


Contents 


binary 


System indicator 




Bit Meaning When Set 




6 VS2 




7 vsi 


binary 


Record type 


binary 


Time, in hundredths of a second, record was 




moved to SMF buffer 


packed 


Date record was moved to SMF buffer in the 




form 00YYDDDF, where F is the sign 


EBCDIC 


System identification 


EBCDIC 


System model identifier 


binary 


Length of rest of record including this field 



For each device removed, there is a four-byte entry with the following format: 

I binary Device class from UCBTYP field of unit 

control block 

1 binary Unit type from UCBTYP field of unit control 

block 

1 binary Channel address 

1 binary Unit address 
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Record Type 1 2 
(End of-Poy) 



Record type 12 is written when a HALT command or a SWITCH command is 
processed. The length is 34 bytes in VSl; 54 in VS2. 

This record includes the system wait time and paging statistics accumulated between 
the expiration time recorded in the last systems statistics record (record type 1 or 
12) and the time a HALT command or a SWITCH command was issued. 

The format is: 

Decimal Hexadecimal Field Data 

Displacement Displacement Size Format Contents 











4 packed 



10 


A 


2 


EBCDIC 


12 


C 


2 


EBCDIC 


14 


E 


4 


binary 



12 



22 


16 


4 


binary 


26 


IA 


4 


binary 


30 


IE 


4 


binary 


folk 


>wing fields apply only 


when 


VS2 is us 


34 


22 


4 


binary 


38 


26 


4 


binary 



42 

46 
50 



2A 

2E 

32 



1 binary System indicator 

Bit Meaning When Set 

6 VS2 

7 vsi 

1 binary Record type 

4 binary Time, in hundredths of a second, record was 
moved to SMF buffer 

Date record was moved to SMF buffer, in the 
form ooyydddf, where F is the sign 

System identification 

System model identifier 

System wait time, in hundredths of a second, 
since the last record type 1 was written' 

4 binary Expiration time of the end of the collection 

period whose statistics are reported in this 
record 

Total page-ins for the entire system during 
the interval 

Total page-outs for the entire system during 
the interval 

Total pages reclaimed for the entire system 
during the interval 



Total number of regions swapped 

Accumulated number of pages paged in when 
regions are swapped 

4 binary Accumulated number of pages paged out 

when regions are swapped 

4 binary Number of regions migrated 

4 binary Accumulated number of pages paged out 
when regions migrated 



1 If the system continues running after the halt command or switch command, the next record 
type 1 contains the wait time accumulated from the halt command or SWITCH command to 
the expiration of the next ten-minute interval. 

Record Type 13 

(Pynamic Storage Configuration) 

Record type 13 (vsi only) is written at ipl and after each DEFINE command is 
processed. It shows the amount of storage assigned to each active problem program 
partition. The length is 16 bytes plus 22 bytes for each partition entry. 
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The format is: 



Decimal Hexadecimal Field Data 

Displacement Displacement Size Format Contents 











binary 



binary 
binary 



4 packed 



10 


A 2 


EBCDIC 


12 


C 2 


EBCDIC 


14 


E 2 


binary 


ach 


active problem program partition, there 




1 


binary 




2 


binary 




2 
1 


binary 
binary 




16 


EBCDIC 



System indicator 

Bit Meaning When Set 

7 vsi 

Record type 

Time, in hundredths of a second, record was 
moved to SMF buffer 

Date record was moved to SMF buffer, in the 
form ooyydddf, where F is the sign 

System identification 

System model identifier 

Number of bytes remaining, including this 
field 



Partition number 

Storage in IK blocks 

Reserved 

Number of job classes 

Job classes specified by EBCDIC letters A-o, 
assigned to this partition. The job classes are 
in their specified order, adjusted right, and 
padded to the left with blanks. 



Record Type 30 
(Start TS) 



Record type 30 (VS2 only) is written each time the time sharing option is started 
with a START TS command. The length is 106 bytes plus 5 bytes for each TS region 
entry. 

This record contains the record type, time stamp (time and date), CPU identification, 
time sharing initiation procedure name, time sharing task identifier, time sharing 
member name in SYS1.PARMLIB, SMF foreground options, maximum number of TS 
regions, TSC region size, time sharing driver name, number of terminals allowed, 
number of time sharing regions, size of each time sharing region, and LSQA size in 
each time sharing region. 



The format is: 

Decimal Hexadecimal Field 

Displacement Displacement Size 











Data 
Format 

binary 



binary 
binary 

packed 



10 


A 


2 


EBCDIC 


12 


C 


2 


EBCDIC 


14 


E 


8 


EBCDIC 


22 


16 


8 


EBCDIC 


30 


IE 


8 


EBCDIC 



Contents 

System indicator 

Bit Meaning When Set 

6 VS2 

Record type 

Time, in hundredths of a second, record was 
moved to SMF buffer 

Date record was moved to SMF buffer, in the 
form ooyydddf, where F is the sign 

System identification 

System model identifier 

Time sharing procedure name 

Time sharing task identifier 

Member name in sysi.parmlib 



112 OS/VS System Management Facilities (SMF) 



Decimal Hexadecimal Field Data 

Displacement Displacement Size Format Contents 



Record Type 31 
I (Initialization) 



38 



26 



binary 



39 
40 

42 
50 

52 
78 

82 

84 

85 

87 

88 

89 

91 

92 

93 

95 

96 

97 

99 

100 

101 

103 

105 



27 
28 
2A 
32 
34 
4E 

52 

54 

55 
57 
58 
59 
5B 
5C 
5D 
5F 
60 
61 
63 
64 
65 
67 
69 



2 

26 

4 



binary 
binary 
EBCDIC 

binary 
binary 
binary 



2 binary 
1 binary 



binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 



For each TS region, there is a five-byte entry with 

1 binary 

2 binary 
2 binary 



SMF foreground options 
Bit Meaning When Set 

System and job data to be collected 

1 System, job, and step data to be 
collected 

2 Exits requested 

3 Data set accounting 

4 Volume accounting 

5 Reserved 

6 Temporary data set scratch records 

7 tso is active 

Maximum number of TS regions 

TSC region size (in 2K blocks) 

Time sharing driver name 

Maximum number of TS terminals allowed. 

Reserved 

Total auxiliary storage available to TSO (in 2K 
blocks) 

Total auxiliary storage available to 
background (in 2K. blocks) 

Percentage of backup in use for tso user 
regions 

Maximum number of TS users allowed 

Device class of first swap device 

Unit type of first swap device 

Channel/unit address of first swap device 

Device class of second swap device 

Unit type of second swap device 

Channel/unit address of second swap device 

Device class of third swap device 

Unit type of third swap device 

Channel/unit address of third swap device 

Device class of fourth swap device 

Unit type of fourth swap device 

Channel/unit address of fourth swap device 

Length of rest of record including these bytes 

Number of TS regions 

the following format: 

Region number 

LSQA size (in 2K blocks) 

Region size (in 2K blocks) 



Record type 31 (VS2 only) is written each time the TIOC initialization routine is 
entered by the time sharing control (TSC) task as the result of a START TS 
command. The length is 54 bytes. 

This record contains the record type, time stamp (time and date), CPU identification, 
total number of time sharing buffers, size of time sharing buffers, maximum number 
of output buffers allowed each terminal before OWAIT (program wait for output 
buffers), and maximum number of input buffers allowed each terminal before 
LWAIT (terminal lockup). It also contains the OWAIT threshold (the number of 
buffers that must be freed in order to be freed from OWAIT), RESTART threshold 
(the number of buffers that must be freed in order to be freed from LWAIT), 
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number of buffers reserved on the free queue, number of users that constitute slack 
time, size of one terminal sharing block, and logged-on user change. 

The format is: 

Decimal Hexadecimal Field Data 

Displacement Displacement Size Format Contents 







26 



34 

1 OWAIT 
buffers 

2 LWAIT 

buffers 







1A 



22 



binary 



binary 
binary 



4 packed 



10 


A 


2 


EBCDIC 


12 


C 


2 


EBCDIC 


14 


E 


2 


binary 


16 


10 


2 


binary 


18 


12 


2 


binary 


20 


14 


2 


binary 


22 


16 


2 


binary 


24 


18 


2 


binary 



2 binary 



28 


1C 


2 


binary 


30 


IE 


2 


binary 


32 


20 


1 


binary 


33 


21 


1 


binary 



20 binary 



System indicator 

Bit Meaning When Set 

6 VS2 

Record type 

Time, in hundredths of a second, record was 
moved to SMF buffer 

Date record was moved to SMF buffer, in the 
form ooyydddf, where F is the sign 

System identification 

System model identifier 

Total number of buffers 

Buffer size 

Reserved 

Maximum number of output buffers allowed 

per terminal before owait 1 

Maximum number of input buffers allowed 
per terminal before LWAIT 2 

OWAIT threshold. The number of buffers that 
must be freed in order to be freed from 
OWAIT. 

RESTART threshold. The number of buffers 
that must be freed in order to be freed from 

LWAIT. 

Number of buffers reserved on the free queue 
Number of users that constitute slack time 
Size of one terminal status block 

Logged-on user change (indicates when 
maximum number of output buffers allowed 
per terminal before OWAIT and lwait are to 
be recalculated; user specifies this in START 
TS command) 
Reserved 



is the suspension of the program during input/output to the terminal because no output 
are available. 

is the locking up of the terminal user's keyboard because he has filled all the input 
available to him. 



Record Type 32 
(Driver) 



Record type 32 (VS2 only) is written each time the driver initialization routine is 
entered by the TSC task as a result of a START TS command. The length is 46 bytes 
plus 20 bytes for each subqueue entry. 

This record contains the record type, time stamp (time and date), CPU identification, 
driver control flags, guaranteed background execution percentage, wait estimate 
constant, and region estimate constant. For each subqueue the following information 
is recorded: the region number, number of service cycles to be given to the users on 
the subqueue, amount of storage allowed to users on the subqueue, maximum main 
storage occupancy time allowed to users on the subqueue, average service time for 
users on the subqueue, and the minimum time slice to be given to a user on the 
subqueue. 
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The format is: 



Decimal 



Hexadecimal — Field Data 



Displacement Displacement Size 



10 

12 
14 



Format 

binary 



binary 
binary 



4 packed 



EBCDIC 
EBCDIC 

binary 



15 

16 

20 

24 



10 
14 
18 



binary 

binary 
binary 
binary 



Contents 

System indicator 

Bit Meaning When Set 

6 VS2 

Record type 

Time, in hundredths of a second, record was 

moved to SMF buffer 

Date record was moved to SMF buffer, in the 

form 0OYYDDDF, where F is the sign 

System identification 

System model identifier 

Driver control flags — that specify which 
fields are to be ignored by the driver 

Bit Ignore When Set 

Wait estimate 

1 Region activity 

2 Main storage occupancy 

3 Swap load 

4 Average queue service time 

5 Background to foreground ratios 

6 Scheduling of priority 

7 Current rqel 

Percentage of CPU time to be given to 

background jobs 

Constant used to determine wait estimate 

Constant used to determine region estimate 

Length of rest of record not including this 

field 



For each subqueue for each region, there is a 20-byte entry with the following format: 

1 binary 

1 binary 

2 binary 



2 binary 
The remainder of the record contains the following field: 

20 binary Reserved 



Reserved 

Region number 

Number of service cycles to be given to 

subqueue 
binary Amount of storage in 2K blocks allowed to 

user on subqueue 
binary Maximum main storage occupancy time, in 

hundredths of a second, allowed to user on 

subqueue 
binary Average service time, in hundredths of a 

second, for user on subqueue 
binary Minimum time slice, in hundredths of a 

second, for user on subqueue 

Reserved 
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Record Type 33 
(Driver Modify) 



Record type 33 (VS2 only) is written each time the driver modify routine is entered 
as a result of a modify driver command if background keyword is specified. The 
length is 16 bytes. 

This record contains the record type, time stamp (time and date), CPU identification, 
driver control flags, and background execution percentage. 

The format is: 

Decimal Hexadecimal Field Data 

Displacement Displacement Size Format Contents 







10 
12 
14 







binary 



binary 
binary 

packed 

EBCDIC 
EBCDIC 

binary 



15 



binary 



System indicator 

Bit Meaning When Set 

6 VS2 

Record type 

Time, in hundredths of a second, record was 
moved to SMF buffer 

Date record was moved to SMF buffer, in the 
form ooyydddf, where F is the sign 

System identification 

System model identifier 

Driver control flags — that specify which 
fields are to be ignored by the driver 

Bit Ignore When Set 

Wait estimate 

1 Region activity 

2 Main storage occupancy 

3 Swap load 

4 Average queue service time 

5 Background to foreground ratios 

6 Scheduling of priority 

7 Current RQEL (Request 
Queue Element List) 

Percentage of CPU time to be given to 
background jobs (specified in MODIFY TS 
command) 



Record Type 41 
(Modify TS) 



Record type 41 (VS2 only) is written each time a MODIFY TS command is issued if 
any keywords other than background are specified. The length is 81 bytes plus 5 
bytes for each TS region entry. 

This record contains the record type, time stamp (time and date), CPU identification, 
time sharing initiation procedure name, time sharing task identifier, SMF foreground 
options, and maximum number of terminals allowed. For each time sharing region 
that is modified, there is an entry consisting of the total number of regions, region 
number for each modified region, LSQA in the region, and size of the region. 
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The format is: 



Decimal Hexadecimal Field Data 

Displacement Displacement Size Format 







10 

12 
14 
22 
30 
38 



39 
40 

44 

46 
50 

52 
78 
80 







A 
C 

E 
16 
IE 
26 



27 
28 

2C 

2E 

32 

34 
4E 
50 



1 binary 



4 

2 

26 

2 



binary 
binary 



4 packed 



EBCDIC 
EBCDIC 
EBCDIC 
EBCDIC 

binary 
binary 



binary 
binary 

binary 

binary 
binary 

binary 
binary 
binary 



Contents 

System indicator 

Bit Meaning When Set 

6 VS2 

Record type 

Time, in hundredths of a second, record was 

moved to SMF buffer 

Date record was moved to SMF buffer, in the 

form 00YYDDDF, where F is the sign 

System identification 

System model identifier 

Time sharing initiation procedure name 

Time sharing task identifier 

Reserved 

SMF foreground options 

Bit Meaning When Set 

System and job data to be collected 

1 System, job, and step data to be 
collected 

2 Exits requested 

3 Data set accounting 

4 Volume accounting 

5 Reserved 

6 Temporary data set scratch records 

7 TSO is active 

Percent of backup in use for TSO user regions 
Total auxiliary storage available to TSO (in 2K. 
blocks) 

Total auxiliary storage available to 
background (in 2K blocks) 

Reserved 

Maximum number of time sharing users 

allowed 

Reserved 

Length of rest of record, including this field 

Number of regions 



For each time sharing region that has 
following format: 

1 

2 



been modified, there is a five-byte entry with the 

binary Region number 

binary LSQA (Logical System Queue Area) in region 

(in 2K blocks) 
binary Size of region (in 2K blocks) 
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Record Type 42 
(Stop TS) 



Record type 42 (VS2 only) is written by the terminate function of the TSC during the 
termination of time sharing options. It is also written when the TSC abnormally 
terminates one or more time sharing regions and none is restarted. The length is 50 
bytes. 

This record consists of the record type, time stamp (time and date), CPU 
identification, time sharing initiation procedure name, and time sharing task 
identifier. 

The format is: 

Decimal Hexadecimal Field Data 

Displacement Displacement Size Format Contents 





1 




1 


1 
1 


binary 
binary 


System indicator 

Bit Meaning When Set 

6 VS2 

Record type 


2 


2 


4 


binary 


Time, in hundredths of a second, record was 



4 packed 



10 


A 


2 


EBCDIC 


12 


C 


2 


EBCDIC 


14 


E 


8 


EBCDIC 


22 


16 


8 


EBCDIC 


30 


IE 


20 


binary 



moved to SMF buffer 

Date record was moved to SMF buffer, in the 
form ooyydddf, where F is the sign 

System identification 

System model identifier 

Time sharing initiation procedure name 

Time sharing task identifier 

Reserved 



Record Type 43 
(RTAM Start) 



Record type 43 (VS1 only) is written by RTAM during RTAM initialization. The 
length is 42 bytes, plus a six-byte entry for each line created. 

This record contains the record type, time stamp (time and date), CPU identification, 
RTAM start procedure name, maximum number of readers and writers supported, 
number of times to activate, and number of lines to start at this time. For each line 
created, a six-byte entry containing line name and unit address is made. 

The format is: 

Decimal Hexadecimal Field Data 

Displacement Displacement Size Format Contents 











binary 



1 


1 


1 


binary 


2 


2 


4 


binary 


6 


6 


4 


packed 


10 


A 


2 


EBCDIC 


12 


C 


2 


EBCDIC 


14 


E 


2 


binary 


16 


10 


2 


binary 


18 


12 


2 


binary 



System indicator 

Bit Meaning When Set 

7 vsi 

Record type 

Time, in hundredths of a second, record was 

moved to SMF buffer 

Date record was moved to SMF buffer, in the 

form ooyydddf, where F is the sign 

System identification 

System model identifier 

Subsystem identification — X'0001' signifies 
RTAM 

Reserved 

Length of rest of record, not including this 

field 
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Decimal Hexadecimal Field Data 
Displacement Displacement Size — Founat Contents 



Record Type 44 
(RTAM Modify) 



20 

28 
36 
37 
38 
39 
40 
41 



14 
1C 

24 
25 
26 
27 
28 
29 



EBCDIC RTAM start procedure name 

binary Reserved 

binary Maximum number of readers supported 

binary Maximum number of writers supported 

binary Number of entries in LINE table 

binary Number of line DCTs 

binary Number of lines to activate 

binary Number of lines to start at this time 



For each line DCT created, there is a six-byte entry, as follows: 

3 EBCDIC Line name 

3 EBCDIC Unit address, in the form cuu where c is the 
channel and uu is the unit 



Record type 44 (vsi only) is written by RTAM whenever a MODIFY RTAM command 
is issued. The length is 30 bytes, plus a six-byte entry for each line modified. 

This record contains the record type, time stamp (time and date), CPU identification, 
RTAM start procedure name, type of modification (start, stop, or restart), and 
number of lines modified at this time. For each line modified, a six-byte entry 
containing line number and unit address is made. 

The format is: 



Decimal Hexadecimal Field Data 

Displacement Displacement Size Format 











1 



binary 



binary 
binary 



4 packed 



10 


A 


2 


EBCDIC 


12 


C 


2 


EBCDIC 


14 


E 


2 


binary 


16 


10 


2 


binary 


18 


12 


2 


binary 


20 


14 


8 


EBCDIC 


28 


1C 


1 


binary 



29 ID 1 binary 

For each modified line, there is a six-byte entry, 

3 EBCDIC 
3 EBCDIC 



Contents 

System indicator 

Bit Meaning When Set 

7 vsi 

Record type 

Time, in hundredths of a second, record was 

moved to SMF buffer 

Date record was moved to SMF buffer, in the 

form ooyydddf, where F is the sign 

System identification 

System model identifier 

Subsystem identification — X'0001' signifies 

RTAM 

Reserved 

Length of rest of record, not including this 

field 

rtam start procedure name 

modify type 

Value Meaning 

1 Start 

2 Stop 

3 Restart 

Number of lines modified at this time 

as follows: 

Line number 

Unit address, in the form cuu where c is the 

channel and uu is the unit 
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Record Type 45 
(RTAM Stop) 



Record Type 47 
(LOGON) 



Record type 45 (VS1 only) is written by RTAM when a STOP RTAM command is 
issued. The length is 30 bytes. 

This record contains the record type, time stamp (time and date), CPU identification, 
RTAM start procedure name, STOP status, and number of lines started when the 
STOP was received. 

The format is: 



Decimal Hexadecimal Field Data 

Displacement Displacement Size Format 











binary 



binary 
binary 

packed 



10 


A 


2 


EBCDIC 


12 


C 


2 


EBCDIC 


14 


E 


2 


binary 


16 


10 


2 


binary 


18 


12 


2 


binary 


20 


14 


8 


EBCDIC 


28 


1C 


1 


binary 



29 



ID 



binary 



Contents 

System indicator 

Bit Meaning When Set 

7 vsi 

Record type 

Time, in hundredths of a second, record was 
moved to SMF buffer 

Date record was moved to SMF buffer, in the 
form 00YYDDDF, where F is the sign 

System identification 

System model identifier 

Subsystem identification — X'0001' signifies 
RTAM 

Reserved 

Length of rest of record, not including this 
field 

RTAM start procedure name 

STOP begun or ended: 

Value Meaning 

Begun 

1 Ended 

Number of lines started when STOP was 
received 



Record type 47 (vsi only) is written by RTAM whenever a valid LOGON record is 
received by RTAM. The length is 152 bytes. 

This record contains the record type, time stamp (time and date), CPU identification, 
QID entry, passback area, and LOGON record. 
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The format is: 



Decimal Hexadecimal Field Data 

Displacement Displacement Size Format 

1 binary 



Record Type 48 
(LOGOFF) 



o 



o 



1 binary 
4 binary 

4 packed 



Contents 

System indicator 

Bit Meaning When Set 

1 VSl 

Record type 

Time, in hundredths of a second, record was 
moved to SMF buffer 

Date record was moved to SMF buffer, in 
form ooyydddf, where F is the sign 

System identification 

System model identifier 

Subsystem identification — X'0001' signifies 
RTAM 

Reserved 

Length of rest of record, not including this 

field 

QlD entry 

Passback area— X' 8000 0000' 

LOGON record 



Record type 48 (VSl only) is written by RTAM whenever a LOGOFF record is 
received by RTAM. The length is 68 bytes. 

This record contains the record type, time stamp (time and date), CPU identification, 
and qid entry. 



10 


A 


2 


EBCDIC 


12 


C 


2 


EBCDIC 


14 


E 


2 


binary 


16 


10 


2 


binary 


18 


12 


2 


binary 


20 


14 


48 


binary 


68 


44 


4 


binary 


72 


48 


80 


EBCDIC 



The format is: 

Decimal Hexadecimal Field 

Displacement Displacement Size 







10 
12 
14 

16 
18 

20 







A 
C 
E 

10 

12 

14 



Data 
Format 

binary 



binary 
binary 



4 packed 



EBCDIC 
EBCDIC 

binary 

binary 
binary 



Contents 

System indicator 

Bit Meaning When Set 

7 vsi 

Record type 

Time, in hundredths of a second, record was 

moved to SMF buffer 

Date record was moved to SMF buffer, in 

form ooyydddf, where F is the sign 

System identification 

System model identifier 

Subsystem identification — X'0001' signifies 

RTAM 

Reserved 

Length of rest of record, not including this 

field 



48 binary QID entry 
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Record Type 49 
(RTAM Integrity) 



Record type 49 (vsi only) is written by RTAM whenever an invalid LOGON record is 
received by RTAM. The length is 152 bytes. 

This record contains the record type, time stamp (time and date), CPU identification, 
QID entry, passback area, and LOGON area. 

The format is: 

Decimal Hexadecimal Field Data 

Displacement Displacement Size Format Contents 







10 

12 
14 

16 
18 

20 
68 

72 







A 
C 
E 

10 
12 

14 

44 
48 



1 binary System indicator 

Bit Meaning When Set 
7 vsi 

1 binary Record type 

4 binary Time, in hundredths of a second, record was 
moved to SMF buffer 

4 packed Date record was moved to SMF buffer, in 
form ooyydddf, where F is the sign 

2 EBCDIC System identification 

2 EBCDIC System model identifier 

2 binary Subsystem identification — X'0001' signifies 
RTAM 

2 binary Reserved 

2 binary Length of rest of record, not including this 
field 

48 binary QID entry 

4 binary Passback area— X'FFOO 0000' 

80 EBCDIC LOGON area 
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Appendix A: Field to Record Cross Reference 



This appendix lists all of the fields in the SMF records in alphabetical order and gives the record type containing each 
field and the displacement of the field within the record. 

Record types 30-35 and 40-42 are available only when you are using SMF in a VS2 system. Record type 26 is 
available only in a VS2 system that includes HASP. Record types 43-45 and 47-49 are available only in a VSl system. 



Field Name 


Record 
Type 


Displacement 


Decimal 


Hex. 


Accounting fields 


4 


102+ 


66+ 


5 


117 


75 


20 


61 


3D 


34 


102+ 


66+ 


35 


117 


75 


Alternate tracks available 


19 


46 


2E 


Auxiliary storage available to background 


30 


84 


54 


41 


44 


2C 


Auxiliary storage available to TSO 


30 


80 


50 


41 


40 


28 


Block size 


21 


40 


28 


Buffer size 


31 


16 


10 


Channel and unit address 


19 


60 


3C 


21 


22 


16 


Cleaner actions 


21 


37 


25 


Constant used to determine wait estimate 


32 


16 


10 


CPU time used by job 


5 


113 


71 


Cylinders available (unallocated) 


19 


48 


30 


Data set name 


17 


40 


28 


DCB/deb segment 


14 


240 


F0 


15 


240 


F0 


Device added entry 


9 


14 


E 


10 


38 


26 


Device allocation time 


4 


86 


56 


34 


86 


56 


Device class, unit type, and channel/unit address for swap devices 


30 


89 


59 


Device entry 


4 


104 


68 


34 
40 


104 
62 


68 
3E 


Device removed entry 


11 


14 


E 


Device type 


19 


32 


20 
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Field Name 


Record 
Type 


Displacement 


Decimal 


Hex. 


Driver control flags 


32 


14 


E 


33 


14 


E 


DSCBs (total number) 


19 


42 


2A 


DS4VTOCI 


19 


41 


29 


Erase gaps 


21 


35 


23 


Estimated execution time 


26 


96 


60 


Estimated output 


26 


100 


64 


Execution start time and date 


26 


128 


80 


Execution stop time and date 


26 


136 


88 


Extents available (unallocated) 


19 


56 


38 


FCB identifier 


6 


76 


4C 


Form number 


6 


53 


35 


Format DSCBs 


19 


44 


2C 


Functional indicators 


40 


39 


27 


Generated output records 


26 


164 


A4 


HASP assigned job number 


26 


40 


28 


26 


74 


4A 


hasp execution selection priority 


26 


74 


4A 


HASP logical output device name 


6 


68 


44 


26 


80 


50 


HASP output selection priority 


26 


76 


4C 


I/O status 


6 


51 


33 


Input route code 


26 


78 


4E 


JFCB segment 


14 


64 


40 


15 


64 


40 


Job class 


26 


73 


49 


Job completion code 


5 


51 


33 


35 


51 


33 


Job initiation time and date 


5 


39 


27 


Job input class 


5 


71 


47 


Job name 


4 


14 


E 


5 


14 


E 


6 


14 


E 


10 


14 


E 


14 


14 


E 


15 


14 


E 


17 


14 


E 
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Field Name 



Record 
Typ e 



Displacement 



D e cimal 



4Je*^ 



Job name (continued) 



Job options 



Job priority 



Job termination indicator 



Limit of continuous wait time for job 



Line number 



Lines per page 



Line-in count, number of TGETs satisfied 



Line-out count, number of TPUTs issued 



Logged-on user change 



LOGON area 



Logon enqueue time 



Logon priority 



LOGON record 



Logon time 



Main storage occupancy time 



Main storage used 



Maximum number of input buffers allowed per terminal before LWAIT 



Maximum number of output buffers allowed per terminal before OWAIT 



Maximum number of readers 



Maximum number of TS regions 



Maximum number of TS terminals allowed 



Maximum number of TS users allowed 



Member name in sysi.parmlib 



Modified time sharing region entry 



modify type 



Module identification or drive number of devices having movable address plugs 



New data set name 



Noise blocks 



Number of buffers 



Number of buffers reserved on free queue 



Number of bytes in real storage 



Number of bytes in SMF buffer 



Number of bytes in virtual storage 



20 



26 



26 



44 



26 



34 



35 



34 



35 



31 



49 



35 



35 



47 



34 



35 



40 



34 



34 



31 



31 



43 



30 



30 



30 



41 



30 



41 



44 



19 



31 



31 



14 



14 



14 



39 



53 



62 



14 



30 



114 



47 



47 



43 



43 



33 



72 



54 



53 



72 



22 



22 



22 



39 



74 



22 



20 



36 



39 



50 



87 



50 



30 



28 



62 



84 



34 



14 



28 



27 



22 



27 



35 



3E 



IE 



72 



2F 



2F 



2B 



2B 



21 



48 



36 



35 



48 



16 



16 



16 



27 



4A 



16 



14 



24 



27 



32 



57 



32 



IE 



51 



1C 



3E 



54 

22 



E 
1C 
IB 

12 
16 
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Field Name 


Record 
Type 


Displacement 


Decimal 


Hex. 


Number of cylinders in largest free extent 


19 


52 


36 


Number of data sets processed by writer for this job 


6 


52 


34 


Number of input cards 


26 


160 


A0 


Number of lines modified 


44 


29 


ID 


Number of lines started when STOP received 


45 


29 


ID 


Number of records in DD DATA and DD * read for the job 


5 


47 


2F 


Number of records written by writer 


6 


47 


2F 


Number of regions 


41 


80 


50 


Number of regions swapped 


1 


34 


22 


12 


34 


22 


Number of SMF records lost 


7 


14 


E 


Number of steps in job 


5 


38 


26 


Number of tracks in largest free extent 


19 


54 


36 


Number of TS regions 


30 


105 


69 


Number of users that constitute slack time 


31 


30 


IE 


Number of volumes 


17 


87 


57 


18 


131 


83 


Old data set name 


18 


40 


28 


Online I/O device entry 


8 


14 


E 


Output processor start time and date 


26 


144 


90 


Output processor stop time and date 


26 


152 


98 


Output route code 


6 


88 


58 


OWAIT threshold 


31 


24 


18 


Owner identification of direct access volume 


19 


22 


16 


Page count 


6 


84 


54 


Page-ins for job step 


4 


+0 




Page-ins for system during interval 


1 


22 


16 


12 


22 


16 


Page-ins for TSO session 


34 


+0 




Page-outs for job step 


4 


+4 




Page-outs for system during interval 


1 


26 


1A 


12 


26 


1A 


Page-outs for TSO session 


34 


+4 




Pages paged in when regions are swapped 


1 


38 


26 


12 


38 


26 


Pages paged out when regions are migrated 


1 


50 


32 


12 


50 


32 


Pages paged out when regions are swapped 


1 


42 


2A 


12 


42 


2A 
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Record 


Displacement 






n i 


„ 








Type 




Hex. 






Pages reclaimed for system during interval 


1 


30 


IE 






12 


30 


IE 






Partition characteristic entry 


13 


16 


10 






Partition or region size 


4 


70 


46 






Passback area 


47 


68 


44 






49 


68 


44 






Percent of backup in use for TSO user regions 


30 


86 


56 






41 


39 


27 






Percent of CPU time given to background jobs 


32 


15 


F 






33 


15 


F 






Print copy count 


26 


112 


70 






Print form number 


26 


104 


68 






Print route code 


26 


116 


74 






Printed lines 


26 


172 


AC 






Printed pages 


26 


176 


B0 






Problem program load time 


4 


90 


5A 






34 


90 


5A 






Program name 


4 


54 


36 




1 


Programmer's accounting number 


26 


88 


58 






Programmer's name 


5 


93 


5D 






20 


40 


28 






26 


52 


34 






Programmer's room number 


26 


92 


5C 






Punch form number 


26 


108 


6C 






Punch route code 


26 


118 


76 






Punched cards 


26 


180 


B4 






QID entry 


47 


20 


14 






48 


20 


14 






49 


20 


14 






Read errors (permanent) 


21 


32 


20 






Read errors temporary) 


21 


28 


\C 






Reader device class and type 


5 


69 


45 




1 


Reader stop time and date 


26 


120 


78 






Record indicators 


4 


98 


62 






14 


38 


26 






15 


38 


26 






Record type 


All 


1 

47 


1 






Records in DD DATA and DD * read for the job step 


4 


2F 
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Field Name 


Record 
Type 


Displacement 


Decimal 


Hex. 


Regions migrated 


1 


46 


2E 


12 


46 


2E 


Reserved for your use 


34 


30 


IE 


35 


30 


IE 


40 


30 


IE 


Restart threshold 


31 


26 


1A 


RTAM start procedure 


43 


20 


14 


44 


20 


14 


45 


20 


14 


Segment sizes 


14 


40 


28 


15 


40 


28 


Session CPU time 


35 


113 


71 


Size of one terminal status block 


31 


32 


20 


Size of region 


34 


70 


46 


SMF foreground options 


30 


38 


26 


41 


38 


26 


SMF options 





26 


1A 


Start I/Os 


21 


30 


IE 


) 
Starting date at which no data set was available for recording SMF records 


7 


20 


14 


Step completion code 


4 


51 


33 


34 


51 


33 


Step CPU time 


4 


102+ 


66+ 


34 


102+ 


66+ 


Step dispatching priority 


34 


53 


35 


Step initiation time and date 


4 


39 


27 


Step name 


4 


62 


3E 


34 


62 


3E 


Step number 


4 


38 


26 


Step priority 


4 


53 


35 


Step sequence number 


34 


38 


26 


40 


38 


26 


Step termination indicators 


4 


83 


53 


34 


83 


53 


Steps in session 


35 


38 


26 


Stop begun or ended 


45 


28 


1C 


Storage protect key 


4 


82 


52 


5 


72 


48 


34 


82 


52 


35 


72 


48 
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Field Name 



Record 
"Type- 



Displacement 



Decimal 



HexT 



Storage used 



74 



4A 



Subqueue entry 



32 



26 



1A 



Subsystem identification 



43 



44 



45 



47 



48 



49 



14 



14 



14 



14 



14 



14 



Swaps that occurred for session 



34 



+8 



sysout class 



38 



26 



SYSOUT class indicator 



63 



3F 



SYSOUT classes for session 



35 



63 



3F 



System identification 



All 



10 



System indicator 



All 



System wait time 



14 



System wait time since last record type 1 



12 



14 



Tape density 



21 



39 



27 



Terminal monitor program name 



34 



54 



36 



Termination indicators 



35 



62 



3E 



Time and date of sysout start 



39 



27 



Time and date reader recognized end of job 



54 



36 



Time and date reader recognized job card 



10 



14 



15 



17 



26 



22 



22 



22 



22 



22 



22 



22 



22 



22 



16 



16 



16 



16 



16 



16 



16 



16 



16 



Time and date record moved to SMF buffer 



All 



Time of end of collection period 



12 



12 



Time of end of interval 



12 



Time of start of data loss 



16 



10 



Time reader recognized job card 



Time record was written to the dump data set 



Time sharing driver name 



20 



30 



22 



2 

_ 2 
42 



16 



2A 
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Field Name 


Record 
Type 


Displacement 


Decimal 


Hex. 


Time sharing initiation procedure name 


41 


14 


E 


42 


14 


E 


Time sharing procedure name 


30 


14 


E 


Time sharing task identifier 


30 


22 


16 


41 


22 


16 


42 


22 


16 


TIOT segment 


14 


48 


30 


15 


48 


30 


Tracks available (unallocated) 


19 


50 


32 


TS region entry 


30 


106 


70 


TSO region size 


30 


40 


28 


TSO swap page-ins 


34 


+ 12 




tso swap page-outs 


34 


+ 16 




UCB segment 


14 


264 


108 


15 


264 


108 


ucb type 


21 


24 


18 


ucs identifier 


6 


80 


50 


Unit address 


44 


33 


21 


User identification field from common exit parameter area 


4 


30 


IE 


5 


30 


IE 


6 


30 


IE 


10 


30 


IE 


14 


30 


IE 


15 


30 


IE 


17 


30 


IE 


18 


30 


IE 


20 


30 


IE 


26 


30 


IE 


34 


14 


E 


35 


14 


E 


40 


14 


E 


User identification field from QIDLGNID field 


5 


76 


4C 


6 


57 


39 


Volume serial number 


17 


88 


58 


18 


132 


84 


19 


14 


E 


vtoc address 


19 


36 


24 


Write errors (permanent) 


21 


33 


21 


Write errors (temporary) 


21 


29 


ID 
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Index 



Indexes to systems reference library manuals are 



consolidated in OS/ VS Master Index , GC28-0602. 
For additional information about any subject listed 
below, refer to other publications listed for the same 
subject in the Master Index . 

Note: If more than one page number is given, the 
primary discussion is listed first. The entries in the 
index appear the same way they appear in the body 
of the book, which means that entries with bold type 
or italic type in the body of the book appear in bold 
type or italic type in the index. 

I 5 

b 5 

[] 5 

{} 5 

A 

accounting field format 61 

accounting records 

complete descriptions 75 

introduction 14 

allocating space for SMF data sets 42 

allocating space on direct access devices 42 

allocation recovery record (type 10) 

complete description 109 

introduction 17 

ALT parameter , 36 

alternate SMF data set parameter (alt) 36 

analysis and report routines 49 

ASMFCL procedure . 69,51 

assemble and link edit procedure 49 

auxiliary storage requirements 42 

SMF data sets 42 

system libraries 43 

B 

blocking of SMF records 41 

braces 5 

brackets 5 

BUF parameter 35 

buffer, SMF 

main storage requirement 41 

specifying 35 

buffer size parameter (buf) 35 

c 

cataloged procedure, ASMFCL 69,51 

class, sysout 81 

coding examples (see examples) 
commands 

HALT 47,43 

records written when issued 111,100 

MODIFY RTAM 119 

MODIFY TS 116 

START TS 112,113,114 

STOP RTAM 120 

SWITCH 47,43 

records written when issued 111,100 

VARY . 109,110 

common parameter area 55 

communication area 54 



compatibility — , — — , — . . 24" 

between vsi and mft . 24 

between vsi and VS2 25 

between VS2 and MVT . 24 

configuration record, I/O (type 8) 

complete description 108 

introduction . 17 

conventions, notational 4 

CPU model number parameter (mdl) 32 

CTRLPROG macro instruction 30 

QSPACE parameter 30 

SYSQUE parameter 30 

D 

data-collection parameters 37,13 

data set/direct access volume (dsv) 34 

system/job/step (OPT) 34 

temporary data set (rec) 35 

data generator utility program (iebdg) 68 

used by TESTEXIT 71 

data lost record (type 7) 

complete description 107 

introduction 17 

data management considerations 42,46 

data sets 

installation defined 55 

SMF 

allocating direct access space for 46 

alternate 36,43 

primary 36,43 

resident on direct access 42,46 

temporary 

HDRDATA 49 

SORDATA 49 

data set activity records 

complete descriptions 89 

introduction 14 

designing a report program 50 

direct access devices 

determining appropriate extents 43 

specifying extents 46 

direct access volume record (type 19) 

complete description 100 

introduction 16 

driver modify record (type 33) 

complete description 116 

introduction 18 

driver record (type 32) 

complete description 114 

introduction 18 

DSV parameter 34 

dump header record (type 2) 

complete description 106 

introduction 17 

dump program, SMF 47 

dump trailer record (type 3) 

complete description 107 

introduction 17 

dynamic DD record (type 40) 

complete description 88 

introduction 15 

dynamic storage configuration record (type 13) 

complete description Ill 

introduction 17 
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E 

end of day record (type 12) 

complete description Ill 

introduction 17 

Error Statistics by Volume (esv) 

in record type 21 101 

ESV parameter 30 

ESV record (type 21) 

complete description 101 

introduction 16 

examples 

adding exit routines to SYS1.AOS00 28 

adding exit routines to SYS1.LINKLIB 29 

adding exit routines to SYSl.LPALlB 30 

adding IEFUTL to SYSl. NUCLEUS 29 

allocating space on direct access devices 47 

entering exit routines into EXITLIB 72 

entering smfdeflt into sysi.parmlib 40 

executing the SMF dump program 47 

obtaining a listing of sample SMF exit routines .... 53 
obtaining a listing of sample sort exit routines .... 50 

obtaining a punched deck of TESTEXIT 72 

sample JCL for iebptpch utility program .... 72,50,53 

sample JCL for IEBUPDTE utility program 69,72 

sample JCL to run smffrmt 52 

sample output from smffrmt 52 

sample SMFDEFLT data set 32 

sample sort procedure 51 

SMFWTM macro definition required for testing .... 68 

TESTEXIT procedure . 69 

writing system output messages from IEFACTRT ... 64 

EXCP count 76,84,88,90,92 

execution time limit 62 

exit routines, SMF 53,19 

characteristics of subpools 54 

conventions 54 

data sets used by 55 

effect on system throughput 19 

facilities and restrictions 53 

for both vsi and VS2 20 

for vsi only 20 

for VS2 only 20 

IEFACTRT 63,20 

IEFUIV 65,20 

IEFUJI 60,20 

IEFUJP 64,20 

iefujv 59,20 

iefusi 61,20 

iefuso 66,20 

IEFUTL 62,20 

IEFU83 66,20 

incorporating into the system 27 

load module assignments for 28 

main storage requirements 41 

parameters . 55 

SMFDEFLT parameter 37 

specifying 37,38 

testing 67 

when BASIC or FULL is coded 31 

when taken 19 

EXT parameter 37 

for TSO , 38 



F 

format 

exit routine parameters 55 

HALT macro instruction 47 

IFASMFR macro instruction 58 

SMF records 75 

SMFDEFLT parameters 39 

SMFWTM macro instruction . 57 

switch macro instruction 47 



GETMAIN macro instruction 54 

used in testing exit routines 67 

H 

HALT command 

operation 47,43 

records written when issued 111,100 

HASP record description 

type 26 (job purge) 82 

HDRDATA temporary data set 49 

I 

IEBDG utility program, used by TESTEXIT 68,71 

IEBPTPCH utility program 

sample JCL 72,50,53 

IEBUPDTE utility program 

sample JCL 69,72 

IEFACTRT exit routine 63,20 

parameters passed 63 

return codes 64 

sample routine 64 

writing system output messages 64 

IEFUIV exit routine 65,20 

parameters passed 65 

return codes 65 

IEFUJI exit routine 60,20 

parameters passed 60 

return codes 61 

sample routine 61 

IEFUJP exit routine 64,20 

parameters passed 65 

IEFUJV exit routine 59,20 

parameters passed 59 

return codes 60 

sample routine 60 

IEFUSI exit routine 61,20 

parameters passed 61 

return codes 61 

IEFUSO exit routine 66,20 

parameters passed 66 

return codes 66 

IEFUTL exit routine 62,20 

parameters passed 62 

return codes 62 

sample routine 63 

IEFU83 exit routine 66,20 

parameters passed 67 

return codes 67 

sample routine 67 

IFASMFDP program 47 

incorporating SMF into the operating system 27 

initial program loader (ipl) 46 

initialization of SMF 46 

input stream validation exit routine (see IEFUIV exit routine) 

installation data sets 55 

installation written routines ( see user written exit routines) 
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input or RDBACK data set activity record (type 14) 

complete description 90 

introduction 15 

I/O configuration record (type 8) 

complete description 106 

introduction 17 

written during initialization 46 

I/O error during initialization 46 

I/O macro instruction, SMF 

format 57 

RDW used with 58 

return codes 58 

IPL procedure 46 

I PL record (type 0) 

complete description 104 

introduction 17 

written during initialization 46 

J 

JCL examples ( see examples) 

job commencement record (type 20) 

complete description 97 

introduction 15 

job execution time limit 62 

job initiation exit routine {see IEFUJI exit routine) 

job log number 

in allocation recovery records 109 

in data set activity records 90,92,95,96,97 

in job termination records 79 

in output writer records 81 

in step termination records 76 

job purge exit routine ( see IEFUJP exit routine) 

job purge record (type 26) 

complete description 82 

introduction 15 

job termination record (type 5) 

complete description 79 

introduction 15 

job validation exit routine ( see IEFUJV exit routine) 

job wait time limit 62 

parameter to specify (JWT) 32 

jobqlmt parameter 30 

JWT parameter 32 

L 

linkage editor 

examples 69,28 

use in TESTEXIT 71,27 

load module assignments for exit routines 28 

LOGOFF record (type 35) 

complete description 86 

introduction 15 

LOGOFF record (type 48) 

complete description 121 

introduction 18 

LOGON record (type 47) 

complete description 120 

introduction 18 

LSQA 112,116 

LWAIT . 113 



M 

macro instructions, used with SMF 

CTRLPROG 30 

GETMAIN 54,67 

IFASMFR . 58 

SCHEDULR 30 

SMFWTM 57 

main storage requirements 41 

nucleus and system link pack areas 41 

system and partition queue areas 41 

communication area 54 

SMF buffer 41 

system management control area (smca) 41 

timing control table (TCT) 41 

MAN parameter 33 

MANX data set 36,42 

MANY data set 36,42 

MDL parameter 32 

messages, sysout 18 

modify TS command 116 

modify TS record (type 41) 

complete description 116 

introduction 18 

N 

notation conventions 4 

o 

OFF parameter 38 

operating system 

adding SMF to 27 

relationship to SMF 21 

operation of SMF example 21 

operator intervention 46 

parameter (OPl) 36 

operator, system 46 

OPI parameter 36 

OPT parameter 34 

for TSO 38 

output writer 81 

written by installation 81 

output writer record (type 6) 

complete description 81 

introduction 15 

output, updat, inout or OUTIN data set activity 
record (type 15) 

complete description 92 

introduction 15 

OWAIT 113 

p 

parameter format 

SMFDEFLT 39 

SMF exit routines 55 
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parameters, used to specify SMF 

ALT 36 

BUF 35 

DSV 34 

EXT 37 

for TSO '. . . . .... . ... . . . . ... . 38 

JWT '. 32 

MAN 33 

MDL 32 

OFF 38 

OPI 36 

OPT 34 

for TSO 38 

PRM 36 

REC 35 

SID 32 

PCI (program controlled interruption) 76 

performance, SMF 43 

primary SMF data set, specifying 36 

( see also SMF data set) 

primary SMF data set parameter (PRM) 36 

PRM parameter 36 

program controlled interruption (PCI) 76 

programming examples ( see examples) 

Q 

QSPACE parameter 30 

R 

RDW (record descriptor word) 58 

REC parameter 35 

record descriptor word (rdw) 58 

record modifications 

from MFT for VS1 24 

from mvt for VS2 25 

from VSl for VS2 25 

records, SMF (see SMF records) 

records, SYSOUT 18 

records, user written 57 

reenterable attribute 54 

rename data set status record (type 18) 

complete description 96 

introduction 15 

report program 49 

designing 50 

sample (smffrmt) 50 

obtaining a source deck and listing 50 

requirements, auxiliary storage (see auxiliary storage 
requirements) 

requirements, main storage (see main storage requirements) 

RES records 

type 43 (rtam start) . 118 

type 44 (rtam modify) 119 

type 45 (RTAM STOP) 120 

return codes 

IEFACTRT exit routine 64 

IEFUIV exit routine 65 

IEFUJI exit routine 61 

IEFUJP exit routine 65 

IEFUJV exit routine 60 

IEFUSI exit routine 61 

IEFUSO exit routine 66 

IEFUTL exit routine 62 

IEFLJ83 exit routine 67 

SMFWTM macro instruction 58 

routines, user written 

exit 53 

report 49 



RTAM integrity record (type 49) 

complete description 122 

introduction 18 

RTAM MODIFY record (type 44) 

complete description ............... 119 

introduction 18 

RTAM start record (type 43) 

complete description , 118 

introduction 18 

RTAM STOP record (type 45) 

complete description 120 

introduction 18 

s 

sample SMF exit routines 

IEFACTRT . 64 

IEFUJI 61 

IEFUJV 60 

IEFUTL 63 

IEFU83 67 

obtaining a listing of 53 

SCHEDULR macro instruction 30 

ESV parameter 30 

JOBQLMT parameter 30 

SMF parameters 30 

scratch data set status record (type 17) 

complete description 95 

introduction 15 

secondary storage requirements (see auxiliary storage) 

selecting SMF records 

using SMFDEFLT parameters 37 

using TSO parameters 39 

SID parameter 32 

SMF 

data collection function 13 

definition 13 

exits 19 

incorporating into the operating system 27 

initialization 46 

operation example 21 

performance 43 

relationship to the operating system 22 

specifying at system generation 30 

storage required for 41 

SMF buffer 

main storage requirement 41 

specifying 35 

SMF data set 

allocating direct access space for 46 

alternate data set parameter (alt) 36 

auxiliary storage requirements 42 

dumping of 47 

MANX 36,42 

many 36,42 

primary data set parameter (prm) 36 

resident on direct access 42 

specifying in SMFDEFLT 36 

verification of 46 

SMF dump program 47 

execution of 47 

SMF exit parameter (ext) 37 

for TSO 38 

SMF exit routines (see exit routines, SMF) 

SMF parameter of SCHEDULR macro 30 

SMF performance 43 
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SMF records 

blocking 41 

formats 75 

parameter (man) 33 

selecting 37,39 

size W~ 

spanning • . 42 

standard header 58 

sysout 18 

types 14 

type (ipl) 

complete description 104 

introduction 17 

when written 46 

type 1 (system statistics) 

complete description 104 

introduction 17 

type 2 (dump header) 

complete description 106 

introduction 17 

type 3 (dump trailer) 

complete description 107 

introduction 17 

type 4 (step termination) 

complete description 76 

introduction 15 

type 5 (job termination) 

complete description 79 

introduction 15 

when written 55 

type 6 (output writer) 

complete description 81 

introduction 15 

type 7 (data lost) 

complete description 107 

introduction 17 

type 8 (I/O configuration) 

complete description 108 

introduction 17 

when written 46 

type 9 (vary online) 

complete description 109 

introduction 17 

type 10 (allocation recovery) 

complete description 109 

introduction 17 

type 1 1 (vary offline) 

complete description 110 

introduction 17 

type 12 (end-of-day) 

complete description Ill 

introduction 17 

type 13 (dynamic storage configuration) 

complete description Ill 

introduction 17 

type 14 (INPUT or RDBACK data set activity) 

complete description 90 

introduction 15 

type 15 (output, updat, inout, or outin data 
set activity) 

complete description 92 

introduction 15 

type 17 (scratch data set status) 

complete description 95 

introduction 15 

type 18 (rename data set status) 

complete description . 96 

introduction 15 

type 19 (direct access volume) 



complete description 100 

introduction 16 

type 20 (job commencement) 

complete description 97 

introduction 15 

type 21 (ESV) 

complete description 101 

type 26 (job purge) 

complete description 82 

introduction 15 

introduction 16 

type 30 (start ts) 

complete description 112 

introduction 17 

type 31 (TIOC initialization) 

complete description 113 

introduction 17 

type 32 (driver) 

complete description 114 

introduction 18 

type 33 (driver modify) 

complete description 116 

introduction 18 

type 34 (TS-step termination) 

complete description 84 

introduction 15 

type 35 (logoff) 

complete description 86 

introduction 15 

type 40 (dynamic dd) 

complete description 88 

introduction 15 

type 41 (modify TS) 

complete description 116 

introduction 18 

type 42 (stop ts) 

complete description 118 

introduction 18 

type 43 (rtam start) 

complete description 118 

introduction 18 

type 44 (rtam modify) 

complete description 119 

introduction 18 

type 45 (rtam stop) 

complete description 120 

introduction 18 

type 47 (LOGON) 

complete description . . . 120 

introduction 18 

type 48 (logoff) 

complete description 121 

introduction 18 

type 49 (RTAM integrity) 

complete description 122 

introduction 18 

SMF record exit (see IEFU83 exit routine) 
SMFDEFLT 

adding or replacing parameters from console .... 31 

contents and format 32 

entering into SYS1.PARMLIB 39 

parameters 32 

restrictions 39 

sample • • 32 

verification 46 

SMFFRMT 50 
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SMFWTM macro instruction 

format 57 

macro definition 67 

RDW used with 58 

return codes 58 

used in testing 67 

SORDATA temporary data set . 49 

sort/ merge program 49 

restrictions 49 

sample exit routines 49 

sample JCL 50 

sample procedure 51 

standard SMF record header 58 

step execution time limit 62 

step initiation exit routine (see IEFUSI exit routine) 

step termination record (type 4) 

complete description 76 

introduction 15 

storage requirements, SMF . 41 

auxiliary storage requirements 42 

SMF data sets 42 

system libraries 43 

main storage requirements 41 

exit routines 41 

nucleus 41 

partition queue areas 41 

system link pack areas 41 

system queue area 41 

SWITCH command 

format 47 

operation 47 

records written 100,111 

SYSGEN 30 

SYSOUT class 81 

SYSOUT limit (see IEFUSO exit routine) 

SYSOUT messages 18 

SYSOUT writer 81 

system generation 30 

system identification parameter (sid) 32 

system libraries 

storage requirements 43 

SYS1.AOS00 27 

SYSl.AMODGEN 58 

SYS1.ASAMPLIB 

sample sort exit routines 49 

SMFEXITS 53 

SMFFRMT 50 

TESTEXIT 67 

SYS1.LINKLIB 27 

SYS1.LPALIB 27 

SYS1.MACLIB 57 

SYS1.NUCLEUS 27 

SYS1.PARMLIB 21 

adding smfdeflt to 39 

verification of 46 

system management control area (SMCA) 41 

system queue area 41 

system statistics record (type 1) 

complete description 104 

introduction 17 

system throughput degradation 43 

system use records 

complete descriptions 103 

introduction 16 

SYSl libraries (see system libraries) 



T 

TCT (timing control table) 41 

temporary data sets 

HDRDATA 49 

SORDATA 49 

termination exit routine (see iefactrt exit routine) 
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